CodeIgniter集成Sentry错误监控方法【教程】

本文详解了CodeIgniter 3.x与4.x集成Sentry进行错误监控的关键差异与实战避坑指南：CI 3.x必须通过Raven_Client显式调用`install()`注册全局异常处理器，且需在框架启动早期（如MY_Loader或autoload中）完成，否则致命错误和未捕获异常将完全静默；而CI 4.x因框架异常拦截机制升级，仅靠`install()`无效，必须借助Events（如`post_controller_constructor`或自定义错误事件）或中间件手动捕获上下文异常，尤其要针对性处理404等不抛出PHP异常的“伪正常”错误；此外，Docker环境下PHP-FPM与Sentry容器共用9000端口导致的curl 52静默失败问题极易被忽视，需通过调整FPM监听端口或使用`host.docker.internal`确保请求准确抵达Sentry服务——每一步配置偏差都可能导致监控形同虚设，堪称CI开发者上线前必查的生死清单。

直接上结论：CI 3.x 可用 Raven_Client + 手动 install() 捕获全局错误；CI 4.x 必须改用官方 sentry/sentry SDK 并配合 Events 或中间件注入，否则 404、路由异常等根本不会进 Sentry。

CI 3.x 中启用全局错误捕获必须调用 install()

很多人只初始化 Raven_Client 却没调用 install()，结果 PHP 错误、致命错误全都不上报。

• Raven_Client 初始化后必须显式执行 $client->install()，它会注册 set_error_handler、set_exception_handler 和 register_shutdown_function
• 别在控制器里初始化再调 install() —— 要放在 application/core/MY_Loader.php 的构造函数或 application/config/autoload.php 加载的自定义启动文件中，确保它在任何业务逻辑前就绪
• 若用了 Monolog，RavenHandler 只负责日志级别消息（如 error()），不替代 install() 对未捕获异常的兜底能力

CI 4.x 中不能只靠 install()，得用 Events::on('pre_system') 或中间件

CI 4 的生命周期更严格，install() 注册的异常处理器会被框架自己的 Exceptions 类拦截并吞掉 —— 尤其是 404、403 这类 HTTP 异常，根本不会触发 PHP 层的 set_exception_handler。

• 推荐方式：在 app/Config/Events.php 中写 Events::on('post_controller_constructor', function () { ... })，并在其中手动捕获当前请求上下文的异常（需配合 try/catch 包裹 CodeIgniter\CodeIgniter::handleRequest()）
• 更稳妥的方式是写一个中间件，在 before() 中设置 set_exception_handler，并在 after() 中恢复原 handler，避免污染其他流程
• 注意：CI 4.3+ 的 Exceptions 类默认会把 404 当作正常流程处理（不抛异常），所以必须监听 Events::on('sparky.error')（如果启用了 Sparky）或自己 patch Router 的 fallback 行为

端口冲突导致 Sentry 请求静默失败（curl error 52）

这是 CI + Docker 环境下最隐蔽的坑：Sentry 容器监听 :9000，而 PHP-FPM 默认也占 localhost:9000 —— curl 发给 http://xxx@localhost:9000/1 实际打到了 FPM，返回空响应，Raven_Client 认为发送成功，但 Sentry 根本没收到。

• 验证方法：在 CI 服务器上执行 curl -v http://your-sentry-dsn@localhost:9000/1，看是否返回 HTML（FPM 默认页）或 404（Sentry 正常）
• 解决方式不是改 Sentry 端口，而是改 FPM：编辑 www.conf，把 listen = 127.0.0.1:9000 改成 listen = 127.0.0.1:9001，再同步更新 Nginx 的 fastcgi_pass
• 容器环境务必用宿主机 IP（如 host.docker.internal）代替 localhost，否则 PHP 容器内访问 localhost:9000 指向的是自己，不是 Sentry 容器

真正容易被忽略的是：CI 4 的 set404Override() 不抛异常，Sentry 捕不到 404；而 CI 3 的 show_404() 是直接输出并 exit，也不会走 Raven_Client 的异常流。这类“非异常型错误”必须单独 hook 路由或响应阶段才能上报。

本篇关于《CodeIgniter集成Sentry错误监控方法【教程】》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！