请求URI中的冒号作用是什么？如何调用Micronaut含冒号的路径接口？

问题原因说明 #

冒号在URI路径中属于合法的普通字符，本身没有特殊的路由语义，你的请求报错本质是Micronaut的URI模板变量默认匹配规则和你的参数校验逻辑冲突了。

你当前定义的@Post("/{someId}:verb")模板，在没有给someId指定匹配规则的情况下，Micronaut会把/之后到路径末尾的所有内容都匹配为someId的取值。你请求/1234:verb时，someId实际拿到的值是1234:verb，自然不符合你设置的@Pattern校验规则，所以请求被拦截。

你之前的几个尝试失败的原因如下：

• POST http://localhost:8080/1234/verb：路径模板中不存在/verb的分段，多写了斜杠导致404
• POST http://localhost:8080/1234:verb：1234:verb被整体识别为someId的取值，未通过参数校验
• POST http://localhost:8080/1234：路径长度不匹配模板，且该路径对应的接口不支持POST方法，返回405

解决方案 #

方案1（推荐）：给路径变量添加明确的正则约束

修改接口的路径注解，给someId加上和你@Pattern规则一致的正则匹配：

// 假设你的someId要求是纯数字，正则可以按需替换成你的校验规则
@Post("/{someId:[0-9]+}:verb")

修改完成后直接请求POST http://localhost:8080/1234:verb即可正常命中接口，此时someId会正确识别为1234，后续的:verb会按模板匹配，也能通过参数校验。

方案2：对冒号做URL编码

如果不想修改接口定义，可以把路径中的冒号替换为URL编码后的%3A，请求路径写为：

POST http://localhost:8080/1234%3Averb

该方式可以正常匹配路由，但编码后的路径可读性差，不推荐长期使用。

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