拆分Serverless服务后，如何消除serverless.yml的无效配置警告？

问题场景 #

为突破CloudFormation资源限制，我将Serverless服务拆分为多个服务，项目结构如下：

aws-backend
  functions
    workers
      serverless.yml // workers service
.env.local
.env.dev
serverless.yml // Rest of the functions in here

尝试在workers服务中引用根目录下的.env.*文件变量时遇到两个问题：

• 使用${env:SLS_AWS_REGION}时直接报错：

  Error:Cannot resolve serverless.yml: Variables resolution errored with:
   - Cannot resolve variable at "provider.region": Value not found at "env" source
  

• 使用${../../env:SLS_AWS_REGION}时能正常运行，但出现配置警告：

  Warning: Invalid configuration encountered
    at 'package.individually': must be boolean
    at 'provider.region': must be equal to one of the allowed values [us-east-1, etc...]
  

解决方案 #

1. 修正.env变量引用语法 #

你用${../../env:SLS_AWS_REGION}的写法是错误的，Serverless的env变量源不支持路径前缀，这种写法能运行属于框架的意外兼容，但会导致变量解析异常，进而触发警告。正确做法是让框架正确加载根目录的.env文件，而非在变量中指定路径：

在workers/serverless.yml中添加useDotenv配置，指定.env文件的路径：

service: workers-service
# 开启dotenv支持，指定根目录的环境文件路径
useDotenv: true
dotenv:
  path: ../../.env.${sls:stage} # 根据stage加载对应环境文件，比如stage=dev时加载../../.env.dev

provider:
  region: ${env:SLS_AWS_REGION} # 直接用env变量源，无需路径前缀
  # 其他provider配置项

package:
  individually: true # 确保这里是布尔值，不是字符串或其他类型

或者，你也可以从根目录执行Serverless命令，让框架自动加载根目录的.env文件：

cd aws-backend && serverless deploy --config functions/workers/serverless.yml --stage dev

2. 消除配置警告 #

• package.individually警告：检查workers/serverless.yml中该配置的取值，必须是布尔类型的true或false，不能是字符串（比如"true"）、空值或其他类型。
• provider.region警告：这个警告要么是.env文件中SLS_AWS_REGION的值拼写错误（比如把us-east-1写成use-east-1），要么是变量解析失败导致值无效。确保.env文件中的区域名是AWS官方支持的有效值，并且通过上述配置正确加载了.env文件。

3. 验证配置正确性 #

执行以下命令查看解析后的完整配置，确认变量是否正确加载：

cd aws-backend/functions/workers && serverless print --stage dev

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