codeigniter 自定义404页需正确配置环境、路由覆盖、nginx转发及异常处理：production下display_errors=off会静默错误；ci3要求page404()无参数且环境为production；ci4需在routes.php设set404override并用闭包或完整类方法名；nginx必须用try_files $uri $uri/ /index.php?$query_string确保查询参数传递；全局异常处理器中须显式设http_response_code(404)。
CodeIgniter 的自定义错误页不是靠「替换模板文件」就能生效的，它必须绕过框架默认的异常捕获链、正确触发 PageNotFoundException，并在 production 环境下不暴露堆栈——否则你看到的永远是白屏或 Apache/Nginx 原生 404。
为什么 $route['404_override'] 不生效
最常见的失败原因是：你改了 application/config/routes.php，但没确认当前环境是否为 production；或者控制器方法签名/命名不符合要求（比如用了构造函数依赖注入但没声明 public function page404()）。
-
$route['404_override']只在路由匹配完全失败时触发，如果 URL 能匹配到某个控制器但方法不存在（如/user/abc中abc()未定义），CI3 默认抛PageNotFoundException，但 CI4 默认走HTTPExceptionInterface流程，行为不同 - CI4 中该配置项已移至
app/Config/Routes.php，且必须用闭包或完整类名+方法名格式，例如$routes->set404Override('App\Controllers\Errors::show404'); - CI3 要求被调用的方法不能有参数（哪怕写成
page404($id = null)都会因反射失败而 fallback 到原生 404）
如何让自定义 404 页面在 Nginx 上显示
即使 PHP 层配置正确，Nginx 仍可能截断请求并返回自己的 404。关键点在于 try_files 指令是否把所有未命中静态资源的请求都交还给 index.php 处理。
- 检查站点 Nginx 配置中是否有类似
location / { try_files $uri $uri/ /index.php?$query_string; }的规则；缺了?$query_string或写成/index.php（无 query）会导致 GET 参数丢失，进而使 CI 路由解析失败，跳过404_override - 若使用
fastcgi_intercept_errors on;，需确保后端 PHP 返回的是 404 HTTP 状态码（而非 200），否则 Nginx 不会启用自定义 error_page - 不要在
location ~ \.php$块里配error_page 404—— 这会让 PHP 尚未执行就由 Nginx 拦截，直接跳过 CI
捕获 PageNotFoundException 并统一处理
比起依赖路由层 fallback，更可控的方式是在全局异常处理器中拦截 PageNotFoundException，手动渲染视图并设置状态码。
- CI4 推荐在
app/Config/Exceptions.php的$handles数组中添加：\CodeIgniter\Exceptions\PageNotFoundException::class => 'App\Exceptions\ErrorHandler::handle404' - 对应方法里必须显式调用
http_response_code(404)，否则浏览器收到的是 200，SEO 和调试工具都会误判 - CI3 没有内置异常映射机制，需在
index.php开头用set_exception_handler()拦住PageNotFoundException，再 include 自定义视图文件，注意此时不能调用 CI 的 Loader 类（尚未初始化）
production 环境下页面空白的真正原因
不是“没写对”，而是 display_errors = Off + log_errors = On 导致错误静默输出到日志，同时框架在 production 下主动禁用所有异常渲染逻辑——包括你写的 page404() 方法，除非它被 404_override 显式调用。
- 验证方式：临时把
ENVIRONMENT改为development，看是否能显示你写的页面；能则说明路径/权限/语法没问题，只是环境开关卡住了 - CI4 中还需确认
app/Config/Logger.php的$threshold是否足够高（至少1才记录 error），否则连错误日志都看不到 - 最隐蔽的坑：自定义 404 视图里用了未加载的辅助函数（如
base_url()），而page404()方法没手动$this->load->helper('url')—— CI3 不会自动加载，直接 fatal error
