The original title is: "The OpenTofu Errors You'll Actually Hit (and How to Fix Them Fast)"

Short summary

A practical field guide covering the most common OpenTofu and Terraform errors—stale state locks, provider checksum mismatches, for_each dependency issues, cycles, and inconsistent plan bugs—with deterministic CLI fixes for each. Solutions include force-unlock, multi-platform provider locking, restructuring for_each keys to use static values, and breaking circular references by extracting self-referential resources. The guide also addresses CI-specific concerns like registry connectivity and setting up a local provider mirror for reproducible pipelines.

• •Stale state locks: verify no active run, then use tofu force-unlock with the lock ID
• •Provider checksum mismatches: run tofu providers lock for all target platforms and commit the updated lock file
• •for_each errors: key maps on static inputs, not computed resource attributes; use targeted apply as an escape hatch

Generated with AI, which can make mistakes.