Cakephp 3.9 POST请求指定路由错误匹配GET路由问题求解

1. 动态路由无参数约束：/api/order/:id 路由未对id参数设置正则匹配规则，CakePHP 3.x默认会将/api/order/后所有非斜杠字符串识别为id参数，包括customer-quotation这类非数字字符串。
2. 路由匹配逻辑优先级：CakePHP路由按定义顺序从上到下匹配，优先校验路径匹配度，路径匹配后才会校验请求方法。如果静态路由路径未先命中，请求落到动态路由规则后，若方法不匹配会直接返回405错误，不会继续向下匹配其他路由。
3. 跨域预检请求冲突：如果接口有跨域场景，浏览器会先发送OPTIONS类型的预检请求，你的POST路由未允许OPTIONS方法，会导致预检请求匹配到后续的动态路由。

1. 给动态路由添加参数约束 #

修改/:id路由的配置，新增id参数的正则规则，限制仅数字可匹配为id：

$routes
    ->connect(
        '/:id',
        ['action' => 'getOrderDetails'],
        [
            '_name' => 'order_details',
            'id' => '\d+' // 新增该行，限制id为纯数字
        ]
    )
    ->setMethods(['GET']);

2. 按需添加跨域预检支持 #

如果接口需要跨域访问，给POST路由添加OPTIONS方法支持：

$routes
    ->connect(
        '/customer-quotation',
        ['action' => 'createOrder'],
        ['_name' => 'create_order']
    )
    ->setMethods(['POST', 'OPTIONS']); // 新增OPTIONS方法支持

3. 校验路由匹配结果 #

使用CakePHP内置命令行工具验证路由匹配是否符合预期：

bin/cake routes check /api/order/customer-quotation post

正常输出应指向OrderController::createOrder动作，若指向getOrderDetails则需进一步检查配置。

• 检查ApiFirewallMiddleware中间件是否存在修改请求方法、重写请求路径的逻辑
• 确认请求头未携带X-HTTP-Method-Override等请求方法覆盖字段，避免实际请求方法被篡改

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