Terraform 状态检查器

在变更前先把 state 读清楚

Terraform 的 terraform.tfstate 是实际资源的账本。账号被回收、资源被手工删除、依赖图里出现环时，最常见的失败不是 apply 报错，而是在计划阶段就已经与真实环境不一致。排障时如果只重跑 terraform plan，很容易把漂移、孤儿资源和依赖循环混在一起。

检查器如何定位问题

• 从 terraform show -json、terraform state list 等 CLI 输出中提取资源地址、类型和当前值，先建立一份可读的 state 快照。
• 用 terraform state pull 与计划文件做对比，识别远端已有但 plan 不再声明的 orphaned resources，避免清理动作误删仍在使用的资源。
• 结合 Terraform Cloud API v2 读取 workspace、run、state version 等上下文，把本地文件和远端锁、执行历史对齐。
• 从资源 depends_on、references 和资源地址引用关系重建图，发现会导致 apply 无法继续的 dependency cycles，并指出成环的资源地址。

使用边界

• 它分析的是 state 与远端 API 返回的数据，不能替代云厂商控制台或底层 API 的权限检查。
• 对自定义 backend、私有模块或高度封装的 provider，仍需人工确认字段含义和资源生命周期。
• 删除资源前应先用只读方式核对 plan；涉及生产环境时，建议在隔离 workspace 中验证后再执行。