CDK Pipeline中Vpc.FromLookup返回无效vpc-12345，求按名称/标签查VPC方法

1. 清除CDK上下文缓存 #

你遇到的vpc-12345是CDK的默认占位符，当第一次VPC查找失败后，CDK会把该值缓存到项目根目录的cdk.context.json文件中，后续运行会直接读取缓存，导致一直返回无效ID。

解决方式：

• 直接删除项目根目录下的cdk.context.json文件
• 或者运行命令精准清除缓存：

  cdk context --clear
  

  若只想移除VPC相关缓存项，可执行：

  cdk context --remove aws:cdk:ec2:vpc-lookup:<对应查找标识>
  

2. 正确配置VPC查找参数 #

按名称查找 #

确保VPC名称完全匹配，且在目标AWS账号和区域中存在。如果Pipeline跨环境部署，需明确指定VPC所在的账号和区域，避免查找范围错误：

var vpc = Vpc.FromLookup(this, "CanamVpc", new VpcLookupOptions()
{
    VpcName = "MyVPC",
    // 若VPC所在账号/区域与当前CDK环境不同，需手动指定
    OwnerAccountId = "123456789012",
    Region = "us-east-1"
});

按标签查找 #

通过标签匹配VPC时，直接在VpcLookupOptions中添加标签键值对即可：

var vpc = Vpc.FromLookup(this, "CanamVpc", new VpcLookupOptions()
{
    Tags = new Dictionary<string, string>
    {
        { "Environment", "Production" },
        { "Name", "MyVPC" }
    },
    OwnerAccountId = "123456789012",
    Region = "us-east-1"
});

3. Pipeline环境下的额外注意事项 #

CDK Pipeline的构建阶段（通常用CodeBuild）需要具备访问AWS资源的权限，否则查找VPC会失败并再次生成占位符ID。需给CodeBuild项目添加以下权限：

• ec2:DescribeVpcs
• ec2:DescribeSubnets
• ec2:DescribeTags

如果是跨账号查找VPC（比如Pipeline在账号A，VPC在账号B），还需确保Pipeline的执行角色拥有跨账号访问账号B的EC2资源描述权限。

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