使用AWS CDK CfnInclude传递参数报错：未找到Environment参数

算力阿峰

2026-7-11

CloudFormation模板引入时参数传递错误分析与解决

常见错误原因

参数名大小写不匹配：AWS CloudFormation参数名称是大小写敏感的。如果模板里参数定义是environment（全小写），但CDK代码里传的是Environment，就会触发找不到参数的错误。
参数传递方式错误：没有通过CfnInclude构造函数的parameters属性传递参数，而是用了其他不正确的方式（比如直接作为栈props传递）。
模板路径错误：templateFile指向的不是包含Environment参数的目标模板，导致加载的模板里根本没有这个参数定义。

正确的参数传递方式

首先确认你的CloudFormation模板里确实存在正确定义的Environment参数，示例模板片段：

Parameters:
  Environment:
    Type: String
    Description: Deployment environment (dev/staging/prod)
    AllowedValues:
      - dev
      - staging
      - prod

然后在CDK代码中通过CfnInclude的parameters属性传递参数，以TypeScript为例：

import { Stack, App } from 'aws-cdk-lib';
import { CfnInclude } from 'aws-cdk-lib/cloudformation-include';

export class MyDeploymentStack extends Stack {
  constructor(scope: App, id: string) {
    super(scope, id);

    // 引入CloudFormation模板并传递参数
    new CfnInclude(this, 'ImportedTemplate', {
      templateFile: './cfn-templates/my-existing-template.yaml',
      parameters: {
        // 键名必须和模板里的参数名完全匹配（大小写一致）
        Environment: 'dev'
      }
    });
  }
}