AWS CDK单元测试因S3Key哈希变更失败，如何验证Lambda代码位置？

在TS项目中为AWS CDK编写单元测试，验证栈中<AWS::Lambda::Function>资源的编译后代码目录位置配置。当前通过硬编码S3Key哈希值做断言：

test('is lambda code location correct',()=>{
template.hasResourceProperties("AWS::Lambda::Function",{
    Code:{
    S3Key:"d3c2479c6eb03922101251992e353c5e3f631cf5a055030bbf6cc6cab81e5198.zip"
}})
});

使用<aws-cdk-lib/assertions>的Template进行测试，原本认为S3Key是代码目录路径的MD5哈希值不会变更，但实际哈希值发生了变化，推测其依赖更多未知因素。

Lambda函数的配置如下：

const lambdaFunction = new lambda.Function(this, 'alb-request', {
    codeSigningConfig,
    runtime: lambda.Runtime.NODEJS_16_X,
    handler: 'index.handler',
    code: lambda.Code.fromAsset(path.join(__dirname, '../src/lambdas/alb-request/dist')),
});

需要找到可靠的方法断言Lambda函数的代码位置保持正确。

方法1：断言S3Key的格式/前缀规则 #

如果你的CDK资产打包后的S3Key有固定前缀（比如基于Lambda名称或目录结构生成），可以用正则匹配替代硬编码哈希值：

import { Match } from 'aws-cdk-lib/assertions';

test('lambda code location matches expected pattern', () => {
  template.hasResourceProperties('AWS::Lambda::Function', {
    Code: {
      S3Key: Match.stringLikeRegexp('alb-request/.*\\.zip')
    }
  });
});

该方式只要代码目录对应的资产前缀不变，测试就能通过，完全不受哈希值变更影响。

方法2：验证资产的源目录（通过CDK元数据） #

CDK会为fromAsset创建的资源添加元数据，记录资产的原始路径。可以直接检查元数据来确认代码来源目录：

import { Match } from 'aws-cdk-lib/assertions';

test('lambda uses correct source directory', () => {
  const lambdaResources = template.findResources('AWS::Lambda::Function');
  // 遍历找到目标Lambda资源（或直接使用其逻辑ID）
  const targetLambda = Object.values(lambdaResources).find(res => 
    res.Properties.FunctionName?.includes('alb-request')
  );

  expect(targetLambda?.Metadata).toEqual(
    Match.arrayWith([
      Match.objectLike({
        'aws:cdk:asset-path': Match.stringLikeRegexp('../src/lambdas/alb-request/dist')
      })
    ])
  );
});

这种方式直接验证代码的源目录，完全不依赖打包后的哈希值，是最可靠的验证方式之一。

方法3：手动指定固定资产哈希 #

如果需要强制固定S3Key的哈希部分，可以在fromAsset时手动设置assetHash参数：

// Lambda配置中指定固定哈希
const lambdaFunction = new lambda.Function(this, 'alb-request', {
    codeSigningConfig,
    runtime: lambda.Runtime.NODEJS_16_X,
    handler: 'index.handler',
    code: lambda.Code.fromAsset(path.join(__dirname, '../src/lambdas/alb-request/dist'), {
      assetHash: 'stable-alb-request-hash', // 自定义固定字符串，或基于目录内容生成稳定哈希
      assetHashType: cdk.AssetHashType.CONTENT // 可选：基于文件内容生成哈希，需确保计算逻辑稳定
    }),
});

之后测试即可硬编码对应的S3Key：

test('lambda code location uses fixed hash', () => {
  template.hasResourceProperties('AWS::Lambda::Function', {
    Code: {
      S3Key: 'stable-alb-request-hash.zip'
    }
  });
});

注意：若选择基于内容生成哈希，需注意文件权限、隐藏文件等因素可能导致哈希变更，不如前两种方法灵活。

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