Terraform本地模块复用异常：主项目自定义输出未显示

1. 检查根模块的输出定义是否正确 #

你需要确保根模块的输出正确引用了对应模块实例的输出值，拼写和实例名称必须完全匹配。

比如，如果你在根模块里这样调用模块：

module "blog_app" {
  source = "./static-app"
  # 自定义参数，比如bucket_name、domain_name等
}

module "admin_app" {
  source = "./static-app"
  # 另一套自定义参数
}

那么根模块的输出文件（比如outputs.tf）必须写成：

output "blog_cf_distribution_id" {
  description = "CloudFront ID for blog static app"
  value       = module.blog_app.cloudfront_distribution_id
}

output "admin_cf_distribution_id" {
  description = "CloudFront ID for admin static app"
  value       = module.admin_app.cloudfront_distribution_id
}

如果这里的模块实例名（blog_app/admin_app）或者模块输出名（cloudfront_distribution_id）写错，Terraform会忽略这个输出，自然不会在apply后显示。

2. 验证模块内部的输出配置 #

进入static-app本地模块，检查outputs.tf文件中的输出是否正确指向CloudFront资源的ID：

output "cloudfront_distribution_id" {
  description = "ID of the CloudFront Distribution"
  value       = aws_cloudfront_distribution.static_app_cf.id
}

这里的aws_cloudfront_distribution.static_app_cf必须和模块中定义的CloudFront资源名称完全一致，否则模块输出本身就是无效的，根模块引用后也不会生成正确的输出。

3. 提前排查语法或引用错误 #

执行terraform plan命令，查看输出部分是否有警告或错误信息。如果根模块的输出引用了不存在的模块实例或属性，Terraform会在plan阶段明确提示，比如Reference to undeclared module或者Unknown attribute这类错误。

4. 检查模块文件的存放位置 #

确保static-app模块的outputs.tf是放在模块目录（./static-app）下，而非根模块目录。如果误将模块的输出文件放在根目录，会导致模块输出被当作根模块输出显示，而你自定义的主输出因为引用错误无法生效。

5. 核对GitHub Action的部署命令 #

如果你的GitHub Action仅执行terraform apply -auto-approve，默认会在日志中显示所有根模块的输出。若需要单独捕获输出值，可以添加步骤：

- name: Get CloudFront IDs
  run: |
    echo "Blog CF ID: $(terraform output -raw blog_cf_distribution_id)"
    echo "Admin CF ID: $(terraform output -raw admin_cf_distribution_id)"

但前提是根模块的输出已经正确定义。

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