serverless-pseudo-parameters插件弃用后的迁移配置指南

前置校验 #

首先确认当前使用的Serverless Framework版本≥2.50.0，执行serverless --version即可查看当前版本，版本不满足先完成升级，原生伪参数能力不支持2.50.0以下版本。

必做调整项 #

• 移除插件相关配置与依赖
  打开项目根目录的serverless.yml文件，找到plugins配置块，删除其中的serverless-pseudo-parameters条目。同时在项目依赖中卸载该插件，根据你使用的包管理器执行对应命令：
  npm项目执行：npm uninstall serverless-pseudo-parameters
  yarn项目执行：yarn remove serverless-pseudo-parameters
• 全量替换伪参数语法
  所有原插件使用的#{AWS:xxx}格式语法，全部替换为框架原生支持的${aws:xxx}格式，完整语法映射关系如下：
  • 旧语法#{AWS::AccountId} → 原生语法${aws:accountId}
  • 旧语法#{AWS::Region} → 原生语法${aws:region}
  • 旧语法#{AWS::StackName} → 原生语法${aws:stackName}
  • 旧语法#{AWS::StackId} → 原生语法${aws:stackId}
  • 旧语法#{AWS::URLSuffix} → 原生语法${aws:urlSuffix}
  • 旧语法#{AWS::NoValue} → 原生语法${aws:noValue}
  • 旧语法#{AWS::Partition} → 原生语法${aws:partition}
  • 旧语法#{AWS::NotificationARNs} → 原生语法${aws:notificationArns}

  原插件支持的伪参数和字符串拼接逻辑（例如#{AWS::Region}-suffix这类写法），原生能力完全兼容，替换语法前缀后不需要调整原有拼接规则。

• 清理冗余的变量解析配置
  如果你之前为了适配旧插件，在serverless.yml中自定义过variablesResolutionMode、变量解析优先级相关配置，现在可以直接删除这类自定义配置，原生伪参数走框架默认解析逻辑即可，不需要额外调整解析规则。
• 本地校验迁移结果
  所有调整完成后，执行serverless package命令查看打包输出的CloudFormation模板，确认不存在#{开头的残留语法、无变量解析报错，就可以正常执行部署。

官方迁移说明参考 #

Serverless Framework官方在2.50.0版本的发布说明、框架变量配置官方文档中，已经明确原生伪参数能力对serverless-pseudo-parameters插件实现了100%功能覆盖，迁移过程不需要调整业务代码、云资源配置逻辑，完成上述调整即可正常使用，不存在功能缺口。

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