如何在CodeIgniter 4中添加自定义500错误页面？

CI4没有提供像$routes->set404Override()那样直接设置500错误页面的快捷方法，但可以通过配置错误视图或自定义异常处理器来实现友好的500错误页面，具体步骤如下：

方法一：直接配置自定义错误视图 #

1. 创建自定义500视图文件
   在app/Views/errors/html/目录下新建error_500.php，编写符合网站风格的友好错误页面内容，示例：

   <!DOCTYPE html>
   <html>
   <head>
       <title>服务器错误</title>
       <style>
           .error-container { text-align: center; padding: 50px; }
           .error-code { font-size: 60px; color: #dc3545; }
           .error-message { font-size: 18px; margin-top: 20px; }
       </style>
   </head>
   <body>
       <div class="error-container">
           <div class="error-code">500</div>
           <div class="error-message">服务器内部错误，请稍后重试</div>
       </div>
   </body>
   </html>
   

2. 修改异常配置文件
   打开app/Config/Exceptions.php，找到$errorViews数组，添加500错误对应的视图路径：

   public $errorViews = [
       '404' => 'errors/html/error_404',
       '500' => 'errors/html/error_500', // 新增该行
       // 其他状态码可按需添加
   ];
   

   同时确保生产环境下关闭调试模式，让自定义视图生效：

   public $showDebug = ENVIRONMENT !== 'production';
   

方法二：自定义异常处理器（适用于需要额外逻辑的场景） #

如果需要在500错误发生时执行额外操作（如记录详细日志、发送告警），可以自定义异常处理器：

1. 创建自定义处理器类
   在app/Controllers/下新建CustomExceptionHandler.php，代码如下：

   <?php namespace App\Controllers;
   
   use CodeIgniter\Exceptions\ExceptionHandler;
   use CodeIgniter\HTTP\RequestInterface;
   use CodeIgniter\HTTP\ResponseInterface;
   use Throwable;
   
   class CustomExceptionHandler extends ExceptionHandler
   {
       public function render(Throwable $exception, RequestInterface $request, ResponseInterface $response)
       {
           // 判断是否为500类错误
           $errorCodes = [500, E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR];
           if (in_array($exception->getCode(), $errorCodes)) {
               // 可在此添加日志记录、告警发送等逻辑
               log_message('critical', '500错误详情: ' . $exception->getMessage());
               
               // 返回自定义500视图
               return view('errors/html/error_500', [], ['status' => 500]);
           }
   
           // 其他错误沿用系统默认处理
           return parent::render($exception, $request, $response);
       }
   }
   

2. 配置使用自定义处理器
   打开app/Config/Exceptions.php，修改$handler为自定义类：

   public $handler = App\Controllers\CustomExceptionHandler::class;
   

注意事项 #

• 开发环境下，$showDebug为true时会显示堆栈跟踪页面，需切换到生产环境（将.env文件中的CI_ENVIRONMENT设为production）才能看到自定义500页面效果。
• 自定义视图需保持与网站整体UI风格一致，提升用户体验。

内容的提问来源于stack exchange，提问作者Mr. NoName