Serverless v3升级后本地环境变量引用失败问题排查

我将Serverless从v2升级到v3后，v2原本能正常运行，但在VS Code中本地调试时，初始化阶段频繁崩溃。排查后确认问题源于引用bashrc文件中的本地环境变量——直接在yml文件中写入固定值就能正常启动调试。按照Serverless升级指南提示添加useDotenv: true到yml文件后，问题仍未解决。

配置对比 #

可正常运行的配置 #

provider:
  name: aws
  stage: 'dev'
  region: 'us-west-1'
  runtime: nodejs16.x
  iam:
    role: 'sls-lamda-role'
  deploymentBucket:
    name: 'sls-bucket'
  vpc:
    securityGroupIds:
      - 'sls-sec-group'
    subnetIds:
      - 'sls-subnet-1'
      - 'sls-subnet-2'

无法运行的配置（使用环境变量引用） #

provider:
  name: aws
  stage: '${env:TARGET_ENV_NAME}'
  region: '${env:TARGET_REGION}'
  runtime: nodejs16.x
  iam:
    role: '${env:SLS_LAMBA_ROLE}'
  deploymentBucket:
    name: '${env:SLS_BUCKET}'
  vpc:
    securityGroupIds:
      - '${env:SLS_VPN_SECURITY_GROUP}'
    subnetIds:
      - '${env:SLS_SUBNET_1}'
      - '${env:SLS_SUBNET_2}'

可行排查与解决方向 #

• 检查VS Code终端的环境变量加载：bashrc中的环境变量可能未在VS Code的终端会话中生效。可以手动在VS Code终端执行source ~/.bashrc后再启动调试；或者修改VS Code设置，让终端启动时自动加载bashrc（例如设置terminal.integrated.profiles.linux.bash.args为["-l"]）。
• 切换环境变量加载方式：useDotenv: true主要用于加载项目根目录的.env文件，而非系统bashrc变量。可以将bashrc中的相关变量复制到项目的.env文件中，配合useDotenv: true测试是否能正常加载。
• 校验变量引用准确性：确认所有${env:XXX}中的变量名称与bashrc里的完全一致，无拼写错误；检查变量值是否包含特殊字符需要转义。
• 调整VS Code调试配置：查看项目的launch.json调试配置，确保未覆盖环境变量，也可以手动在env字段中直接指定所需的变量值进行测试。

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