Hyperf默认屏蔽未捕获异常是因Swoole协程与PHP错误机制不兼容；需设APP_ENV=dev、启用swoole.display_errors、配置logger输出到stderr/stdout，并用--debug启动暴露DI错误。
Hyperf 在 Swoole 长生命周期下，默认会捕获并吞掉未捕获的异常和错误，导致框架报错（如语法错误、类不存在、依赖注入失败等）不显示在控制台或日志中，调试困难。核心原因是 Swoole 的协程上下文与 PHP 默认错误处理机制不兼容，Hyperf 为稳定性默认屏蔽了部分错误输出。
开启错误显示与日志记录
在 config/autoload/exceptions.php 中，确保异常处理器已启用并配置为开发环境友好模式：
- 确认
ExceptionHandler已注册，且Hyperf\ExceptionHandler\ExceptionHandler未被完全禁用 - 将
APP_ENV设为dev（修改.env文件），Hyperf 会自动启用详细错误页和控制台异常打印 - 检查
config/autoload/logger.php中default日志通道是否启用stderror或stdout输出，确保异常写入终端
启用 PHP 错误报告与 Swoole 错误钩子
在 bin/hyperf.php 入口文件顶部添加错误报告开关，并注册 Swoole 级错误监听：
- 加入
error_reporting(E_ALL); ini_set('display_errors', '1');强制显示 PHP 基础错误 - 在
ServerProcessManager::init()后或Swoole\Coroutine::set(['hook_flags' => SWOOLE_HOOK_ALL])前，注册swoole_error事件：Swoole\Runtime::enableCoroutine(true);ini_set('swoole.display_errors', '1'); - 若使用
hyperf-snowflake或自定义协程服务，确保其内部未静默 try-catch 所有异常
检查 DI 容器与服务注册异常
Hyperf 启动阶段的 DI 绑定错误（如注解解析失败、@Inject 类不存在）常被静默忽略，需主动暴露：
- 运行
php bin/hyperf.php start --debug启动，该参数会强制输出容器构建过程中的警告和致命错误 - 在
config/autoload/dependencies.php中避免使用匿名函数做复杂初始化逻辑，改用独立 Provider 类便于调试 - 检查
@Inject注解目标类是否已通过@AutoController、@Service或dependencies.php正确声明
验证协程上下文中的错误传播
协程内抛出的异常若未被 go 或 defer 显式处理，容易丢失。建议统一拦截：
- 在全局协程启动处（如中间件、Command）使用
try...catch包裹业务逻辑 - 对异步任务使用
co::create(function () { ... })时，确保内部有异常捕获并记录到LoggerInterface - 启用
Hyperf\Contract\StdoutLoggerInterface直接输出关键错误，绕过日志通道配置干扰
不复杂但容易忽略：多数“错误不展示”问题其实源于环境变量未生效或日志通道未连通终端，优先检查 .env 和 logger.php 配置一致性。
