Mojolicious路由占位符URL解码不一致：特殊字符资源访问异常

这个问题我之前在项目里也踩过坑，Mojolicious的路由占位符对URL编码的处理逻辑，在遇到加号、斜杠这类特殊字符时确实有容易混淆的地方，我给你拆解下原因和解决办法：

问题根源拆解 #

1. 含加号的标识符访问失败 #

首先要明确URL编码的规范：如果你的资源标识符本身包含+，必须把它编码成%2B，而不是直接保留+。Mojolicious的普通占位符（比如:id）会自动把%2B解码回+，但如果你的请求里直接传了未编码的+，Mojolicious会按照HTTP的传统规则把它解析成空格——这大概率就是你访问失败的原因。

2. 含斜杠的标识符访问失败 #

这是Mojolicious路由的一个典型特性：普通占位符:id是非贪婪匹配，只会匹配到第一个未编码的/。更关键的是，Mojolicious会先对整个请求路径做URL解码，再进行路由匹配。举个例子：

你发送的请求是/resource/a%2Fb（原标识符是a/b，已编码），Mojolicious会先解码成/resource/a/b，然后尝试匹配/resource/:id——这时候:id只会捕获a，剩下的/b找不到对应的路由，自然就返回404了。

针对性解决方案 #

处理加号的正确姿势 #

• 编码阶段：确保把标识符中的+严格替换为%2B，不要偷懒保留+；
• 路由处理：直接通过$c->param('id')就能拿到解码后的+，不需要额外处理逻辑。

处理斜杠的正确姿势 #

要让占位符能匹配包含斜杠（哪怕是编码后的）的标识符，你需要用以下两种方式之一：

方式1：使用通配符占位符*id

通配符占位符会匹配路径中当前位置到末尾的所有内容，包括解码后的斜杠。路由定义示例：

$r->get('/resource/*id')->to('YourController#your_action');

当你发送/resource/a%2Fb请求时，Mojolicious解码后得到/resource/a/b，通配符*id会完整捕获a/b，正好对应你的原标识符。

方式2：使用自定义正则占位符

如果你需要更精确的匹配规则（比如限制标识符的格式），可以自定义正则表达式来覆盖普通占位符的匹配逻辑：

# 匹配任意字符（包括斜杠），直到路径结束
$r->get('/resource/:id', id => qr/.+/)->to('YourController#your_action');

这种方式的效果和通配符类似，但你可以根据需求调整正则（比如qr/[a-zA-Z0-9\/]+/只允许字母、数字和斜杠）。

测试验证示例 #

给你写个极简的测试脚本，你可以跑起来验证效果：

use Mojolicious::Lite;

# 普通占位符：处理不含斜杠的标识符（包括加号）
get '/demo/:id' => sub {
  my $c = shift;
  $c->render(text => "普通占位符解析结果：" . $c->param('id'));
};

# 通配符占位符：处理含斜杠的标识符
get '/demo/*id' => sub {
  my $c = shift;
  $c->render(text => "通配符占位符解析结果：" . $c->param('id'));
};

app->start;

测试请求：

• 发送GET /demo/a%2Bb → 普通占位符返回普通占位符解析结果：a+b
• 发送GET /demo/a%2Fb → 通配符占位符返回通配符占位符解析结果：a/b

这样就能完美解决你遇到的两类特殊字符问题了。

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