如何将JSON字符串作为环境变量配置到serverless.yml中？

以下方案均不需要引入额外外部依赖，可直接在现有serverless.yml配置基础上修改：

• 方案1：双引号包裹+转义内部特殊字符
  你之前的单引号写法会触发YAML语法解析异常，换成YAML标准双引号包裹fallback值，内部JSON的双引号用反斜杠转义即可，写法完全符合YAML语法规范，最终注入的环境变量就是标准可直接解析的JSON字符串：

  config:
    FOOBAR: ${env:FOOBAR, "{\"xxxx\":\"yyyy\"}"}
  

  适合JSON内容较短的场景，缺点是长JSON手动转义易出错，可读性差。

• 方案2：用内置toJSON方法序列化yml内结构化配置
  Serverless Framework原生支持toJSON()变量方法，你可以先在配置中以标准YAML结构写好配置内容，再通过该方法自动序列化为JSON字符串作为默认值，完全不需要处理转义问题：

  custom:
    defaultFoobar:
      xxxx: yyyy
      # 可按需扩展更多字段，不需要写JSON语法
      otherConfig: 123
  config:
    FOOBAR: ${env:FOOBAR, ${toJSON(${self:custom.defaultFoobar})}}
  

  这个方案维护成本最低，不需要额外维护外部JSON文件，也不需要手动处理转义，是日常使用最推荐的写法。

• 方案3：用YAML多行块标量原样存储JSON
  YAML支持用|（literal block scalar）标记将后续缩进块内的内容完全原样识别为字符串，不会解析内部的引号、括号等特殊字符，不需要任何转义，长JSON场景下可读性很好：

  config:
    FOOBAR: ${env:FOOBAR, |
      {
        "xxxx": "yyyy",
        "listConfig": [1, 2, 3],
        "nested": {
          "key": "value"
        }
      }
    }
  

  注意块内的JSON要保持统一缩进，最终注入的字符串会保留换行，但不影响JSON.parse正常解析。

• 方案4：Base64编码存储默认值
  如果你的JSON内容包含大量特殊字符、不想处理任何YAML转义逻辑，可以提前把默认JSON字符串转成Base64编码写入配置，业务代码中先做Base64解码再执行JSON解析即可。Base64字符串仅包含字母、数字和少量常规符号，完全不会触发YAML语法错误：

  config:
    # 对应值为 {"xxxx":"yyyy"} 的Base64编码结果
    FOOBAR: ${env:FOOBAR, "eyJ4eHh4IjoieXl5eSJ9"}
  

  业务代码解析示例：

  const foobarConfig = JSON.parse(Buffer.from(process.env.FOOBAR, 'base64').toString())
  

  缺点是需要额外加解码逻辑，默认值不能直接肉眼识别修改，适合对配置稳定性要求极高的场景。

注意：不要直接在配置中写无引号包裹的裸JSON结构，YAML会自动将其解析为对象，最终注入环境变量时会变成[object Object]字符串，无法正常执行JSON.parse。

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