codeigniter 4 中 set404override() 必须在 routes.php 中紧随 $routes = service('routes'); 之后立即调用，早于所有路由注册；仅接受控制器方法字符串（如 'home::index'）或闭包，且对应方法必须显式 return responseinterface 实例（如 redirect()->to('/') 或 view()），否则失效。
set404Override() 必须在 Routes.php 中调用，且不能晚于路由注册
CI4 的 set404Override() 是全局钩子，但它的生效时机很关键：必须在所有 $routes->get()、$routes->post() 等路由定义之前执行。如果写在路由表后面，框架已构建好匹配逻辑，再设覆盖就无效了。
常见错误是把 set404Override() 放在 service('routes') 初始化之后、或混在其他自定义路由逻辑中间。它应紧贴 $routes = service('routes'); 下方，作为整个路由配置的“第一行业务逻辑”。
- ✅ 正确位置示例：
$routes = service('routes');<br>$routes->set404Override('Home::index');<br>$routes->get('/', 'Home::index'); - ❌ 错误顺序：
$routes->get('/', 'Home::index');<br>$routes->set404Override('Home::index'); // ← 此时已来不及接管 404 - 注意：
set404Override()只接受控制器方法字符串（如'Home::index'）或闭包，不支持数组语法或带命名空间的完整类名（如\App\Controllers\Home::index）
控制器方法必须返回 ResponseInterface，不能只 echo 或 redirect()->to() 后不 return
当使用 set404Override('Home::index') 时，CI4 会调用该方法并**严格依赖其返回值**。若 Home::index() 内部只写 redirect()->to('/') 而没加 return，PHP 会返回 null，框架 fallback 到默认 404 视图。
同样，直接 echo 'hello' 或 $this->render()（无返回）也不行 —— CI4 要的是一个完整的 ResponseInterface 实例。
- ✅ 正确写法（在
App\Controllers\Home中）：public function index()<br>{<br> return view('home'); // 或<br> // return redirect()->to('/');<br> // return $this->response->setStatusCode(200)->setBody('ok');<br>} - ❌ 常见失效写法：
public function index()<br>{<br> redirect()->to('/'); // ← 缺少 return，实际返回 null<br> // 或<br> echo 'home page'; // ← 不是响应对象<br>} - 若重定向后想保留 404 状态码（SEO 场景），需显式设置：
return redirect()->to('/')->setStatusCode(404);
Web 服务器配置会劫持 404，绕过 CI4 的 set404Override()
Nginx/Apache 若自身先判定路径不存在并返回 404，CI4 根本收不到请求 —— set404Override() 自然不触发。这是线上环境最常被忽略的一环。
典型表现：本地开发（PHP 内置服务器或 Apache + .htaccess）正常，一上 Nginx 就退回默认 404 页面或空白页。
- ✅ Nginx 必须确保所有非静态资源都透传给
index.php：location / {<br> try_files $uri $uri/ /index.php?$query_string;<br>} - ✅ Apache 需启用
mod_rewrite且.htaccess生效（检查AllowOverride All）；规则中必须包含RewriteCond %{REQUEST_FILENAME} !-f和!-d - ⚠️ 注意：Nginx 的
error_page 404指令会直接接管，与 CI4 冲突，除非你明确指向/index.php（不推荐）
自定义 error_404.php 视图仅在 set404Override() 未设置时才生效
很多人以为改了 app/Views/errors/html/error_404.php 就能控制所有 404，其实不然。只要 set404Override() 被设为非空值（哪怕是个空闭包），CI4 就完全跳过这个视图文件。
也就是说：error_404.php 是兜底方案，不是主控方案。真要走视图渲染，得让 set404Override() 指向一个返回 view('errors/html/404') 的控制器方法。
- ✅ 想复用自定义视图？写个专用控制器：
class Errors extends BaseController<br>{<br> public function show404()<br> {<br> return view('errors/html/404');<br> }<br>}然后$routes->set404Override('Errors::show404'); - ❌ 不要指望改了
error_404.php后，set404Override('Home::index')还会去读它 —— 完全无关 - 额外提醒：视图路径必须存在且可读，CI4 不会报错提示路径缺失，只会静默回退到白屏或默认 404
set404Override() 就形同虚设。
