Troubleshooting

Fast answers for the issues people hit first.

The most common questions are not about syntax. They are about why an upgrade is blocked, why no rewrite happened, or what happened to secrets and target validation.

When analyze blocks

A blocked finding means the selected version path is not safe as-is. That usually points to removed components, a missing bridge upgrade, or a target inventory problem.

When rewrite applies zero operations

That is normal for manual-change cases. The tool found migration work, but not a deterministic conversion it can safely execute for you.

When assisted rewrite appears

Assisted rewrite is the middle tier between auto-fix and manual-change. The tool can scaffold the target shape in a separate output artifact, but a person still needs to review the result before import.

When secrets appear blank

NiFi does not export sensitive values in a recoverable form. Preserve references, then rehydrate values in the target environment through Parameter Contexts or secret providers.

When target validation fails

Check the selected extensions manifest, target API URL, auth, and process-group target. Missing extensions should be treated as real blockers, not as cosmetic warnings.