Hyperf.env配置开启框架原生错误提示-php教程-PHP中文网

hyperf 不支持 laravel 的 whoops 页面，需三步配置调试：设 app_env=local、启用 debug 级日志并确保 storage/logs 可写、自定义异常处理器返回含 trace 的 json 响应。

hyperf.env配置开启框架原生错误提示

Hyperf 不支持 Laravel 那种 APP_DEBUG=true 直接弹出 Whoops 页面的原生错误提示机制。它默认走协程异常处理器链，错误信息会以 JSON 形式返回（如 {"message":"..."}），不会渲染 HTML 错误页。想在开发中快速看到结构化、带堆栈的错误详情，需分三步配置：

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

确认 .env 文件已正确加载且环境为 local
Hyperf 的调试行为依赖 APP_ENV 值，而非单独的 APP_DEBUG。必须确保：

项目根目录下存在 .env 文件
文件中包含 APP_ENV=local（大小写敏感）
没有系统级环境变量（如 shell 中 export APP_ENV=production）覆盖它
启动后执行 php bin/hyperf.php env 可看到输出 local

启用详细日志并确保日志路径可写
错误不会直接显示在终端或浏览器，而是写入 storage/logs/hyperf.log：

检查 storage/logs/ 目录权限是否允许 PHP 进程写入（Linux/macOS 下常见问题）
确认 config/autoload/logger.php 中 'default' => 'stdlog' 对应的 handler 配置未禁用 debug 级别
日志级别建议设为 'level' => 'debug'，否则 info 及以上级别会过滤掉部分异常上下文

配置自定义异常处理器捕获并格式化错误
Hyperf 默认的 HttpExceptionHandler 仅返回 message 和 status，不带 trace。要看到完整堆栈：

在 config/autoload/exceptions.php 中，将 AppExceptionHandler 放在 HttpExceptionHandler 之后
自定义处理器中显式调用 $throwable->getTraceAsString() 或使用 Throwable::getTrace()

返回响应时手动设置状态码，并把 trace 加入 JSON body，例如：

return $response->withStatus(500)->withBody(new SwooleStream(json_encode([
    'message' => $throwable->getMessage(),
    'file' => $throwable->getFile(),
    'line' => $throwable->getLine(),
    'trace' => $throwable->getTraceAsString(),
], JSON_UNESCAPED_UNICODE)));