为何GitLab CI中dev分支Terraform运行正常，master分支报远程状态端点认证错误

问题定位 #

你遇到的Error refreshing state: HTTP remote state endpoint requires auth报错是GitLab Terraform状态存储的HTTP认证失败导致，和你调用的Terraform子模块无关，不需要额外提供子模块内容。

排查与修复步骤 #

• 用户名不一致问题：对比master分支运行日志和gitlab-ci.yml配置发现，日志中导出的TF_HTTP_USERNAME为JOHN.DOE，但你CI配置的before_script中写死的用户名是MATTHEW.FETHEROLF，说明master分支的运行环境存在其他位置的变量覆盖了该配置，检查你的项目CI/CD变量、群组变量中是否有设置TF_HTTP_USERNAME且仅对master分支生效。
• 缓存污染修复：你当前的CI缓存了.terraform目录，且缓存key为commit sha，旧分支的后端配置会被带入新分支的流水线。修改terraform init命令为terraform init -reconfigure，强制每次init都重新生成后端配置，忽略缓存中的旧认证信息。
• 变量权限与拼写校验：
  1. 检查令牌变量名onbaord_cloud_account_into_monitoring的拼写，大概率是拼写错误（正确应为onboard，少了字母r），拼写错误会导致导出的TF_HTTP_PASSWORD为空值，触发认证失败。
  2. 进入GitLab项目的「设置→CI/CD→变量」页面，检查该令牌变量的权限配置：确认没有设置仅dev分支可见、没有开启「仅保护分支可用」后又没将master加入保护分支列表，确保master分支的流水线可以正常读取到该变量值。
• 临时验证方法：你可以在master分支的before_script中加一行echo $onbaord_cloud_account_into_monitoring，查看日志中是否正常输出令牌值（注意输出后要及时删掉这行，避免令牌泄露），确认变量是否正常传递。

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