Express.js动态路由参数值含冒号时多出前置冒号如何解决？

问题根源 #

你当前遇到的参数解析异常，本质是两个原因叠加导致的：

1. Express默认路由参数使用[^/]+规则匹配，仅默认匹配不含斜杠的字符，参数值自带冒号等特殊符号时会触发解析逻辑异常
2. 你用到了req.apiGateway说明服务部署在AWS API Gateway后，API Gateway默认的路径参数匹配规则会截断带特殊符号的参数，甚至把路由定义里的冒号一并转发到业务逻辑

修复步骤 #

• 首先修改路由参数定义，添加贪婪匹配正则，确保所有参数内容都被正确识别：

const path = '/address';
const partitionKeyName = 'CognitoIdentity';
// 新增(.*)表示匹配参数位置所有后续字符，不受特殊符号影响
const hashKeyPath = '/:' + partitionKeyName + '(.*)';

• 然后调整路由处理逻辑，移除多余的JSON序列化：
  req.params和req.apiGateway中取出的参数本身就是字符串类型，直接返回即可，JSON.stringify会额外给字符串套双引号，容易和实际参数内容混淆：

app.get(path + hashKeyPath, function (req, res) {
  res.json({
    data: req.params.CognitoIdentity,
    dekor: req.apiGateway.event.requestContext.identity.cognitoIdentityId
  });
});

• 最后检查AWS API Gateway配置：
  把对应接口的路径参数配置改为/address/{CognitoIdentity+}，尾部的+表示贪婪匹配，允许参数包含冒号、斜杠等特殊字符，避免API Gateway转发时修改参数内容。

验证 #

发起测试请求/address/eu-west-1:ea6b2959-8718-42b9-b8b8-ce82e9d9e7a0，返回的参数值就会是原始的完整ID，不会带多余前置冒号。

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