Codeigniter4路由传参到控制器返回404错误如何解决？

问题根因 #

你当前配置的两条路由为独立匹配规则：

• 无参数的product请求命中第二条路由，可正常响应
• 带参数的product/xxx请求命中第一条路由返回404，通常由以下原因导致：
  • 控制器命名空间/路径/大小写与路由配置不匹配，CI4对文件、类名大小写敏感
  • 存在优先级更高的同前缀路由（写在当前路由之前），提前拦截了带参请求
  • 未将参数段设为可选，导致两条路由规则存在适配缺口

修复方案 #

方案1：单条路由适配带参与无参场景 #

无需拆分两条路由，直接将参数段设为可选即可同时适配两种请求：

// 路由配置 ?表示前面的参数段为可选
$routes->get('product/(:any)?', 'Public\Publiccontroller::ViewProduct/$1');

注意：CI4中控制器子目录的路径分隔符推荐用反斜杠\，和命名空间保持一致，避免部分环境下斜杠解析异常。

无参数请求时会自动使用控制器方法中定义的默认值$param=1，无需额外配置。

方案2：排查兼容原有拆分路由 #

如果要保留原有的两条路由配置，按以下步骤排查：

1. 确认控制器文件路径为app/Controllers/Public/Publiccontroller.php，类名与文件名完全一致，命名空间声明正确：

<?php
namespace App\Controllers\Public;
use App\Controllers\BaseController;

class Publiccontroller extends BaseController
{
    public function ViewProduct($param=1)
    {
        echo $param;
    }
}

2. 确认所有product相关路由的优先级，将更精确的路由放在前面，泛匹配路由放在后面：

// 先写精确匹配的无参路由
$routes->get('product', 'Public\Publiccontroller::ViewProduct');
// 再写泛匹配的带参路由
$routes->get('product/(:any)', 'Public\Publiccontroller::ViewProduct/$1');

3. 关闭自动路由避免冲突，在app/Config/Routes.php中设置：

$routes->setAutoRoute(false);

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