CodeIgniter 出现 Whoops 错误页说明处于 development 环境且 CI_DEBUG=true，Whoops 是 CI4 内置开发错误处理器，仅在开发环境启用；常见原因包括控制器类名与文件名不匹配、命名空间错误、未加载辅助函数或路由指向不存在的方法。
CodeIgniter 出现 Whoops 错误页，说明框架已捕获到 PHP 异常或错误，但当前环境未正确配置错误显示策略——这通常发生在开发阶段启用了调试模式，而错误本身（如类未找到、方法不存在、语法错误、辅助函数未加载等）未被妥善处理。
确认是否处于开发环境
Whoops 是 CodeIgniter 4 内置的开发专用错误处理器，仅在 APP_ENV=development 且 CI_DEBUG=true 时启用。它不会出现在生产环境。
- 检查
.env文件：确保有app.env = development和ci.debug = true - 若在生产服务器看到 Whoops，请立即修改为
app.env = production并清空writable/cache/目录，否则会暴露敏感路径和代码片段
常见触发 Whoops 的真实原因
Whoops 只是“报错界面”，不是错误根源。高频原因包括：
-
控制器类名与文件名不一致：例如文件名为
Quiz.php，但类定义为class quiz extends BaseController（CI 4 要求首字母大写且严格匹配） -
命名空间错误：CI 4 控制器必须声明
namespace App\Controllers;，漏写或写成App\Controlers（拼写错误）会导致类自动加载失败 -
调用未加载的辅助函数：比如在控制器中直接写
base_url()，但没执行$this->load->helper('url')；或在 404 视图里用了该函数却未全局加载 -
路由指向不存在的方法：如
$routes->get('/', 'Home::missingMethod')，而Home类里没有missingMethod()
快速定位问题的方法
Whoops 页面本身已提供关键线索，重点看顶部的错误类型和堆栈中的第一个非系统文件行：
- 若报
Class 'App\Controllers\XXX' not found→ 检查文件路径、命名空间、文件名大小写 - 若报
Call to undefined function base_url()→ 在对应控制器或视图所在逻辑前补$this->load->helper('url')，或在app/Config/Boot/development.php中统一加载 - 若报
Undefined property: App\Controllers\YYY::$form_validation→ 忘记加载库：$this->load->library('form_validation')
临时关闭 Whoops 查看原始错误（仅限调试）
如果 Whoops 页面卡死或信息不全，可临时禁用它来查看 PHP 原生错误：
- 打开
app/Config/Exceptions.php - 将
public $useSuggest = true;改为false - 或将
public $log = true;设为false避免日志干扰 - 刷新页面，此时会显示标准 PHP 错误（需确保
display_errors = On在 php.ini 中启用）
