Serverless.yml无法使用环境变量？部署时变量解析报错求助

核心问题分析 #

• --env参数用法错误：Serverless Framework的--env是用来指定环境配置文件（如env.dev.yml）的，不是直接传递key=value格式的环境变量。你用--env Environment=dev的写法，根本不会把Environment变量注入到系统环境中，导致${env:Environment}无法解析。
• 配置文件存在拼写不一致：自定义配置里定义的是acccccId，但函数环境变量里引用的是acccId；自定义配置里是TenantId，函数里却用AzureAdTenantId，这些拼写错误会直接导致变量找不到。
• 错误信息中提到的functions.xyz在当前配置里不存在，大概率是旧配置的缓存或残留内容。

具体解决步骤 #

1. 正确传递环境变量 #

有两种可靠方式可以让${env:Environment}拿到正确值：

方式一：部署前导出环境变量

在执行deploy命令前，先将变量导出到系统环境中：

# Linux/Mac
export Environment=dev && sls deploy --stage=dev

# Windows CMD
set Environment=dev && sls deploy --stage=dev

方式二：用--param参数传递（Serverless 3.x支持）

这种方式不需要依赖系统环境变量，直接通过命令行传递参数：

sls deploy --param="env:Environment=dev" --stage=dev

同时需要修改serverless.yml里的变量引用为：

stackName: "${param:env.Environment}"
functions:
    abc:
        name: "${param:env.Environment}"
        environment:
            accountId: ${self:custom.acccccId.${param:env.Environment}}
            # 其他变量同理替换为${param:env.Environment}

2. 修正配置文件中的拼写错误 #

把serverless.yml里的不一致拼写统一修正：

service: azure
frameworkVersion: "3"

provider:
    name: aws
    runtime: nodejs18.x
    stackName: "${env:Environment}" # 或用${param:env.Environment}，根据上面的方式选择

custom:
    accccccId:
        non-prod: xxxx
        prod: xxxxxx
    TenantId:
        non-prod: ${ssm:something}
    #  prod:

functions:
    abc:
        name: "${env:Environment}"
        handler: index.handler
        environment:
            # 修正为custom里定义的acccccId
            accountId: ${self:custom.acccccId.${env:Environment}}
            principalId: "${env:Environment}"
            # 修正为custom里定义的TenantId
            TenantId: ${self:custom.TenantId.${env:Environment}}

3. 清理Serverless缓存 #

如果错误信息里的functions.xyz是旧配置残留，执行以下命令清理缓存后重新部署：

# 移除旧栈（如果不需要保留资源）
sls remove --stage=dev
# 清理本地缓存
sls cache clean

4. 可选：用.env文件管理环境变量 #

如果需要持久化存储环境变量，可以用.env文件：

• 在项目根目录创建.env.dev文件，内容如下：

  Environment=dev
  

• 在serverless.yml中添加：

  useDotenv: true
  

• 部署时通过--env指定加载的环境文件：

  sls deploy --env dev --stage=dev
  

  注意这里--env dev是指加载.env.dev文件，不是直接传递键值对。

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