误删本地terraform.tfstate迁GitLab后端恢复遇state锁308报错如何解决

你遇到的308报错本质不是状态真的被锁定，是Terraform的HTTP后端不支持自动处理重定向，而GitLab的Terraform状态API要求请求地址必须以/结尾，缺失斜杠时GitLab会返回308永久重定向，被Terraform识别为锁获取失败。

优先级最高的修复方案 #

• 先检查你的Terraform代码中HTTP后端的配置，确保address字段的路径末尾加了斜杠，示例正确配置：

terraform {
  backend "http" {
    address = "https://<你的GitLab域名>/api/v4/projects/<项目ID>/terraform/state/<状态名>/"
    # 其余用户名、密码等配置保持不变
  }
}

• 修改配置后执行terraform init -reconfigure重新初始化后端，再重新执行import命令即可，不需要强制解锁。

临时跳过锁校验的方案 #

如果你急需完成导入操作，可以临时加参数跳过锁校验，执行命令：

terraform import -lock=false "module.mymodule.acl" acl-xxx123

注意：该操作存在状态被并发写入覆盖的风险，执行前要确认没有其他人员或流水线在操作同一份状态

真有锁时的强制解锁方案 #

如果确认地址配置正确，确实是状态异常遗留了锁，可以通过GitLab API获取锁ID：直接向你的状态地址拼接/lock路径发送GET请求，返回结果中会包含锁ID，拿到ID后执行：

terraform force-unlock <获取到的锁ID>

按照提示确认即可完成解锁。

内容的提问来源于stack exchange，提问作者CEamonn