Amplify构建Lambda Serverless Express路径参数带冒号前缀问题求解

首先你混淆了Express路由的参数占位符语法和实际请求URL的规则：Express路由定义里的/:参数名写法里的冒号是语法标记，作用是告诉Express这一段路径是动态参数，正常不应该出现在实际请求的URL中。
你当前遇到的问题属于以下两种场景之一，对应解决方案如下：

场景1：请求端写法错误（90%以上概率属于该场景） #

你当前的路由代码完全不需要修改，只要把请求URL里多余的前置冒号删掉即可：

• 错误请求地址：https://xxxxx.execute-api.eu-west-1.amazonaws.com/dev/address/:eu-west-1:xxx-8718-42b9-b8b8-ce82e9d9e7a0
• 正确请求地址：https://xxxxx.execute-api.eu-west-1.amazonaws.com/dev/address/eu-west-1:xxx-8718-42b9-b8b8-ce82e9d9e7a0

调整后路由会正常匹配，req.params[partitionKeyName]拿到的就是不带前置冒号的eu-west-1:xxx-8718-42b9-b8b8-ce82e9d9e7a0，可以直接作为DynamoDB的分区键值使用。

场景2：Amplify生成的API网关配置错误，必须带冒号才能匹配路由 #

如果去掉请求URL里的冒号后返回404，说明Amplify自动生成的API网关路径规则把冒号写入了实际匹配逻辑，可选两种解决方案：

方案A：轻量改造参数处理（改造成本最低） #

直接在业务代码中对拿到的参数做一次前缀清洗即可，示例代码：

app.get(path + hashKeyPath, function (req, res) {
  // 清洗参数前缀冒号
  const rawKey = req.params[partitionKeyName];
  const partitionKey = rawKey.startsWith(':') ? rawKey.slice(1) : rawKey;
  // 后续直接用partitionKey查DynamoDB即可
  res.json({
    partitionKey,
    dekor: req.apiGateway.event.requestContext.identity.cognitoIdentityId
  });
});

方案B：从根源修正路由配置 #

1. 修改代码里的hashKeyPath定义，去掉冒号：

const hashKeyPath = '/' + partitionKeyName;

2. 找到Amplify生成的API网关CloudFormation配置文件，一般路径为amplify/backend/api/<你的API名称>/restapi-stack.template.json，将对应路径的配置从错误的/:{partitionKeyName}修正为API网关标准的路径参数格式/{partitionKeyName}
3. 执行amplify push将配置更新到云端，之后就可以用不带前置冒号的URL正常请求，参数也不会带多余前缀。

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