Serverless Offline本地运行时如何保留!Ref配置并加载.env变量

要解决本地运行时!Ref被解析为[object object]覆盖环境变量的问题，核心思路是根据运行阶段（stage）区分变量来源：本地（dev阶段）加载.env中的变量，部署时使用CloudFormation的!Ref引用资源。以下是两种可行方案：

方案一：直接在环境变量中做阶段判断 #

利用Serverless的变量插值语法，根据当前运行阶段动态选择变量来源：

provider:
  stage: dev # 默认阶段设为dev，本地运行无需额外指定

functions:
  health:
    handler: src/api/health.check
    name: ${self:provider.stackName}-health
    environment:
      USER_POOL_APP_CLIENT_ID: ${sls:stage} == 'dev' ? ${env:USER_POOL_APP_CLIENT_ID} : !Ref UserPoolClient

• 本地运行时（默认dev阶段）：自动读取.env中的USER_POOL_APP_CLIENT_ID值
• 部署时（比如指定--stage prod）：使用CloudFormation的!Ref自动获取用户池客户端ID

方案二：用custom配置块统一管理变量来源 #

如果需要管理多个环境变量，建议在custom块中按阶段分组，提高配置可读性：

custom:
  stageVars:
    dev:
      USER_POOL_APP_CLIENT_ID: ${env:USER_POOL_APP_CLIENT_ID}
    prod:
      USER_POOL_APP_CLIENT_ID: !Ref UserPoolClient

provider:
  stage: dev

functions:
  health:
    handler: src/api/health.check
    name: ${self:provider.stackName}-health
    environment: ${self:custom.stageVars.${sls:stage}}

这种方式可以批量管理多个环境变量，后续新增变量只需在stageVars中对应阶段添加即可。

辅助优化：使用dotenv插件自动加载本地变量 #

如果需要更便捷地加载.env文件，可安装serverless-dotenv-plugin插件：

1. 安装插件：

npm install serverless-dotenv-plugin --save-dev

2. 在serverless.yaml中配置插件：

plugins:
  - serverless-offline
  - serverless-dotenv-plugin

插件会自动根据当前阶段加载对应.env文件（比如.env.dev），无需手动设置环境变量。

问题根源说明 #

本地运行时出现[object object]是因为serverless-offline无法解析CloudFormation的!Ref指令，会将其视为JS对象处理，进而覆盖你手动设置的环境变量。通过阶段判断避开本地环境使用!Ref，就能解决这个冲突。

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