CodeIgniter 4 调试需激活完整链路：确保 .env 正确加载、强制触发错误查看堆栈、利用事件与响应头快速查看上下文、临时直连控制器绕过路由。
确保 .env 环境真正生效
很多人改了 .env 文件里的 CI_ENVIRONMENT = development，却仍看不到错误详情——因为框架根本没读到它。
- 确认文件名是 .env（开头带点，不是 env 或 .env.example）；
- 检查文件权限，确保 PHP 进程能读取（Linux 下常见权限问题）；
- 在 public/index.php 顶部加一行临时检测：
var_dump($_SERVER['CI_ENV'] ?? 'not set');，刷新页面看是否输出development； - 若为
not set，说明 DotEnv 没加载成功，可能因composer install后未生成 autoload，或vendor/autoload.php路径不对。
强制触发错误并看到完整堆栈
CI4 默认在 development 模式下会显示彩色错误页，但有时因输出已开始、或响应头已发送，错误页变白屏或 500。这时可用“硬触发”方式：
- 在控制器任意位置写：
trigger_error('Debug breakpoint', E_USER_ERROR);，立刻中断并显示堆栈； - 用
throw new \Exception('test debug');替代dd()，避免因缓冲区未刷新而卡住； - 禁用缓存：在 app/Config/Cache.php 中设
public $handler = 'dummy';，防止缓存掩盖逻辑问题。
快速查看请求与响应上下文
不用每次写 print_r($request) 或翻日志，CI4 提供了轻量级调试钩子：
- 在 app/Config/Events.php 中注册一个事件：
Events::on('pre_system', function() { \CodeIgniter\Debug\Toolbar\Collectors\Views::setDebug(true); });； - 或更直接：在控制器方法末尾加
$this->response->setHeader('X-Debug-Data', json_encode(['uri' => current_url(), 'ip' => $this->request->getIPAddress()]));，再用浏览器开发者工具看响应头； - 启用内置调试工具栏（需 development 模式 +
app/Config/Toolbar.php中$collectors开启对应项），页面底部会显示数据库查询、时间线、全局变量快照。
绕过路由限制直接调用控制器方法（仅限调试）
当路由配错导致 404，又不想反复改 Routes.php 时，可临时“直连”：
- 在 public/index.php 底部加一段（上线前务必删掉）：
if (isset($_GET['debug_call'])) { $controller = new \App\Controllers\Home(); $controller->index(); exit; }； - 然后访问
http://localhost/?debug_call=1，跳过所有路由逻辑，直接执行方法； - 适合验证控制器本身是否有语法错误、依赖注入失败、或模型初始化异常等底层问题。
