Upstream Source
This page is part of Truthound Orchestration 3.x.
Source repository: seadonggyun4/truthound-orchestration
Upstream docs path: docs/prefect/troubleshooting.md
Edit upstream page: Edit in orchestration
Prefect Troubleshooting¶
Flow Works Locally But Deployment Fails¶
Cause:
- local ephemeral defaults do not match deployment-time environment or saved block expectations
Fix:
- decide whether the deployment should stay ephemeral or block-backed
- verify the saved block exists in the target environment
Saved Block Behavior Is Inconsistent¶
Cause:
- different flows are mixing saved and in-memory blocks without making that explicit
Fix:
- standardize on one block strategy per deployment type
- document block names and ownership
Task Retries Hide Real Configuration Errors¶
Cause:
- retries are masking a bad source or missing connection detail
Fix:
- validate the same path once with retries minimized
- inspect source resolution and preflight behavior