Terragrunt搭配TFLint时变量未使用告警的解决方案咨询

针对你遇到的问题，除了单独添加TFLint忽略注释外，还有以下几种可行方案：

1. 让变量在模块内显式引用 #

如果dns_zone_id是要传递给模块内的子资源或子模块，务必在模块代码里明确写出引用逻辑，比如：

module "dns_records" {
  source      = "./dns_records"
  dns_zone_id = var.dns_zone_id
}

这样TFLint会检测到变量被实际使用，自然不会触发“变量已声明但未使用”的告警。

2. 用Terragrunt的generate块动态生成变量声明 #

通过Terragrunt自动生成包含目标变量的声明文件，替代手动编写variables.tf的部分内容。示例配置：

generate "terragrunt_input_vars" {
  path      = "generated_vars.tf"
  if_exists = "overwrite"
  contents  = <<EOF
variable "dns_zone_id" {
  type        = string
  description = "由Terragrunt传入的DNS Zone ID"
}
EOF
}

这种方式下，TFLint会将生成的变量视为模块对外暴露的标准输入，结合Terragrunt的上下文，能避免误判。

3. 集中配置TFLint规则例外 #

在项目根目录的.tflint.hcl文件中，针对terraform_unused_declarations规则添加例外列表，统一管理由Terragrunt传入的变量：

rule "terraform_unused_declarations" {
  enabled = true
  exclude = [
    "var.dns_zone_id",
    # 可添加其他Terragrunt专属变量
  ]
}

这种方式比逐行加忽略注释更高效，适合多变量场景。

4. 将变量标记为模块输出（按需使用） #

如果这个变量需要被上层模块或Terragrunt后续流程引用，可以在模块的outputs.tf中导出它：

output "dns_zone_id" {
  value = var.dns_zone_id
}

TFLint会认为变量被用于输出，从而消除告警。

关于Terragrunt配置的疑问 #

你没有遗漏Terragrunt的特殊配置，inputs字段本身就是Terragrunt向模块传递变量的标准方式。问题的核心是TFLint的静态分析无法感知Terragrunt的动态传参上下文，因此需要通过上述方法适配两者的逻辑差异。

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