每个人都可以，
拥有SSL证书

最近有反馈说线上出现了 TypeError: Missing parameter name，堆栈指向 path-to-regexp 这个库。

看堆栈是在 dist/index.js 的 name 函数里抛的，错误信息里直接给出了一个链接 https://git.new/pathToRegexpError，说明这属于库内部主动抛出的校验错误，而不是什么奇怪的运行时意外。

出错的地方是 name 函数，它在拿到一个 token 之后，如果发现 token 不存在或者 token 的 value 为空，就直接抛 TypeError。

这个函数被 lexer 调用，而 lexer 在遍历路径字符串时，碰到 : 会开始收集后面的参数名，直到不满足 [a-zA-Z0-9_] 为止。如果冒号后面紧跟着就不是合法字符，那收集到的 value 就是个空字符串，交给 name 之后自然就触发异常了。

具体来说，lexer 的逻辑大致是：遇到 : 时先往 tokens 里 push 一个 { type: 'PARAM', value: '' }，然后指针后移，用一个 while 循环把后面连续匹配 [a-zA-Z0-9_] 的字符拼到 value 上。如果冒号后面跟的是 /、- 或者干脆是字符串结尾，那循环一次都不会进，value 就是初始的空字符串。后面 Iter 遍历 tokens，tryConsume('PARAM') 拿到这个 token 并返回 value，交给 name，name 发现 value 为空就会抛错。

也就是说，只要路径里出现孤立的冒号，或者冒号后面没跟有效的参数名，就会命中这个错误。比如 /user:/、/user/:/、/user/: / 这种，都属于同一类问题。

实际业务里可能是手误把 :id 写成了 : 或者字符串拼接时空掉了参数名。

线上错误日志定位之后发现就是某个接口路由里写成了 '/user:/'，应该是个拼写失误。

修复很简单，补上参数名，改成 '/user/:id' 就行。

但问题不单是修这一个路径，如果项目里有多个地方用到了 path-to-regexp，或者路径是动态拼出来的，最好在入口做一层校验。写了个简单的检查函数，用正则 /:[a-zA-Z0-9_]+/g 去匹配路径，如果匹配到的子串只有冒号没有参数名就提前抛错，这样可以避免请求打到路由层才炸。

另外看了下，当前环境中用的版本偏旧，升到 6.2.1 以上之后，库自身的错误提示会更明确一些，对排查也有帮助。

不过升级并不能让路径变得合法，最终还是要修正路径定义本身。

这里其实容易踩坑的点是：很多人以为 :id 这种写法只要冒号在就不会报错，但实际上冒号后面的字符集是受限制的，连 - 都不算。如果参数名用了 - 或者以数字开头，也可能要查一下文档看是不是符合预期，不然线上跑起来问题就出来了。我们这次纯粹是丢了参数名，所以显式报了 Missing parameter name。