codeigniter 4 中 set_error_handler() 基本无效，因其启动时已在 bootstrap.php 和 codeigniter.php 中硬编码调用系统级错误处理器；正确做法是通过 app/views/errors 下的自定义错误视图（如 error_php.php）接管非致命错误和异常展示，并在 app/config/boot/*.php 中显式加载 url 等 helper。
CodeIgniter 4 不支持直接用 set_error_handler() 替换框架内置错误处理器——你写的函数会被 CI4 的底层机制覆盖，或根本不会被调用。真正起效的方式是扩展或重写系统级错误处理钩子，而不是“注册一个新 handler”。
为什么 set_error_handler() 在 CI4 中基本无效
CI4 启动时在 system/Bootstrap.php 和 system/CodeIgniter.php 中已硬编码调用：set_error_handler('_error_handler')、set_exception_handler('_exception_handler') 和 register_shutdown_function('_shutdown_handler')。这些函数全部定义在 system/Common.php 中，且未开放 public 接口供外部替换。
- 手动调用
set_error_handler()会被后续 CI4 初始化流程覆盖 - 即使提前注册，E_ERROR / E_PARSE 等致命错误仍无法捕获（PHP 本身限制）
- 日志写入、HTTP 状态码设置、视图渲染等逻辑全由 CI4 内部函数控制，外部 handler 拿不到上下文
正确做法：通过 App\Views\errors 自定义错误视图
CI4 将用户可干预的错误出口收束到视图层。所有非致命错误（如 E_WARNING、E_NOTICE）和异常最终都会走到 App\Views\errors\{type}.php，比如 error_php.php、error_exception.php、error_404.php。
- 确保
app/Views/errors/下存在对应文件名（大小写敏感），CI4 会自动加载 - 这些视图中可安全使用
base_url()、site_url()等辅助函数 —— 前提是已在app/Config/Boot/production.php或development.php中加载了urlhelper - 若需记录额外信息，可在视图里调用
\CodeIgniter\Log\Logger::log()，但注意避免触发新错误（如未初始化 Logger）
进阶：重写 _exception_handler 需修改系统文件（不推荐但可行）
如果你确实需要拦截所有未捕获异常（包括 500 级别），唯一可靠路径是复制并修改 system/Common.php 中的 _exception_handler() 函数，然后在 public/index.php 入口处，在 require FCPATH . 'vendor/autoload.php'; 之后、$app->run() 之前插入你的版本：
function my_exception_handler($exception)
{
// 记录自定义字段，如 $exception->getTraceAsString()
\Log::error('Uncaught Exception: ' . $exception->getMessage());
// 强制渲染自定义视图，绕过 CI4 默认逻辑
http_response_code(500);
echo view('errors/custom_exception', ['exception' => $exception]);
exit;
}
set_exception_handler('my_exception_handler');
- 该方式绕过了 CI4 的日志通道和响应包装器，适合紧急兜底，但会丢失框架的上下文注入（如当前路由、请求 ID）
- 每次 CI4 升级都需重新适配，维护成本高
- 不要尝试 patch
_error_handler处理 E_ERROR —— PHP 规定它不可捕获，强行操作只会让脚本静默退出
最容易被忽略的关键点
绝大多数人卡在 404 页面报 Call to undefined function base_url()，这不是错误处理的问题，而是 app/Views/errors/error_404.php 被渲染时，url helper 还没加载。解决方案不是写 handler，而是在 app/Config/Boot/development.php（或 production.php）里加一行：helper(['url']); —— 这才是 CI4 错误视图能用上辅助函数的唯一合法时机。
