Node.js Express路由如何兼容匹配空值路径参数

Angular 13 端发起请求的代码如下：

getJobData(selectedCandle, bypassLoader = false) {
  return this.http.get(`${this.endpoint}/getJobData/${selectedCandle}`, { context: bypassLoaderContext(bypassLoader) });
}

Express 服务端原路由配置如下：

router.get('/getJobData/:selectedCandle(.{0,})', helpers.restAuthorize, async (req, res) => {
  // 业务逻辑
})

实际表现为：selectedCandle非空时路由可以正常命中，参数为空时无法匹配到路由，需要兼容空值、非空值两种传参场景。

Express 路由解析依赖path-to-regexp库，原写法:selectedCandle(.{0,})规则仅对已存在的路径段生效：路由默认要求/getJobData/后必须存在一个路径段，只是这个段的内容可以是0长度字符串；但当参数为空时，要么前端拼出的路径是带末尾斜杠的/getJobData/，要么是无后续段的/getJobData，两种场景都会被判定为路径段缺失，无法命中路由。
另外原写法用的.{0,}正则存在匹配越界问题：.默认匹配包含斜杠在内的所有字符，会误匹配多段路径，不符合参数预期。

1. 后端路由改造（必做） #

两种写法二选一即可，推荐第一种可读性更高：

• 多路径数组匹配，显式覆盖有参数、无参数两种场景，无正则兼容问题：

router.get(
  ['/getJobData', '/getJobData/:selectedCandle'],
  helpers.restAuthorize,
  async (req, res) => {
    // 统一兜底空值，避免返回undefined
    const selectedCandle = req.params.selectedCandle ?? ''
    // 后续业务逻辑
  }
)

• 单路由可选参数写法，注意正则替换为不匹配斜杠的规则，同时给参数加?标记为可选：

router.get(
  '/getJobData/:selectedCandle([^/]*)?',
  helpers.restAuthorize,
  async (req, res) => {
    const selectedCandle = req.params.selectedCandle ?? ''
    // 后续业务逻辑
  }
)

如果服务端开启了strict routing（严格路由模式，即默认区分带/不带末尾斜杠的路径），可以在匹配数组里额外加入/getJobData/路径，保证全场景命中。

2. 前端请求优化（推荐做） #

空参数时不要拼接多余的末尾斜杠，避免无意义的路径格式问题，同时对参数做编码处理避免特殊字符解析错误：

getJobData(selectedCandle: string = '', bypassLoader = false) {
  const requestUrl = selectedCandle 
    ? `${this.endpoint}/getJobData/${encodeURIComponent(selectedCandle)}`
    : `${this.endpoint}/getJobData`
  return this.http.get(requestUrl, { context: bypassLoaderContext(bypassLoader) });
}

• 禁止用.{0,}作为路径参数匹配规则，会吞掉后续多段路径，引发路由逻辑混乱
• 所有从req.params取的可选参数，都要做空值兜底，和前端传空的预期对齐

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