部署Amazon Cognito Passwordless Auth CDK时遇aws-jwt-verify解析错误

排查与修复步骤 #

• 清理CDK缓存
  CDK会缓存依赖状态，旧缓存可能导致解析异常。执行命令清理缓存后重新部署：

  npx cdk clean
  npx cdk deploy
  

• 完全重装依赖
  删除现有依赖文件和锁文件，确保依赖安装完全一致：

  rm -rf node_modules package-lock.json yarn.lock
  npm install
  

  若使用yarn，替换为yarn install。

• 锁定兼容的CDK版本
  数月前可正常运行，大概率是CDK版本更新后与aws-jwt-verify出现兼容冲突。在package.json中指定之前可用的CDK版本：

  "devDependencies": {
    "aws-cdk": "2.XX.X" // 替换为之前成功部署的具体版本号
  }
  

  重新安装依赖后再执行部署。

• 核对依赖导入语句
  检查代码中aws-jwt-verify的导入路径是否正确，避免拼写或路径错误：

  import { CognitoJwtVerifier } from "aws-jwt-verify";
  

• 统一Node.js版本
  不同Node.js版本可能导致依赖解析差异，使用nvm切换至之前成功部署时的Node版本，再重装依赖部署：

  nvm use 18 # 替换为之前的版本号
  rm -rf node_modules package-lock.json
  npm install
  npx cdk deploy
  

• 指定依赖解析路径
  若以上方法无效，在项目根目录的cdk.json中添加配置，明确指定依赖路径：

  {
    "nodeModulesPath": "./node_modules"
  }
  

内容的提问来源于stack exchange，提问作者George Melroy D'Souza