ThinkPHP环境安装中如何查看日志_Runtime日志格式与排查-ThinkPHP-PHP中文网

thinkphp 5/6 日志默认写入 runtime/log/ 目录，需目录可写且未禁用日志；仅触发 log::record()、异常或 app_debug=true 时生成；按天分文件（如 20240520.log）；时间戳为服务器本地时区；常见失败原因为权限不足、磁盘满、swoole 多进程冲突等。

thinkphp环境安装中如何查看日志_runtime日志格式与排查

日志文件在哪？默认路径和生成条件

ThinkPHP 5/6 的 Runtime 日志默认写在 runtime/log/ 目录下，但这个目录必须可写，且应用未禁用日志（'log' => ['enable' => false] 会直接跳过）。
不是所有请求都会写日志——只有触发了 Log::record() 或发生异常、调试开启（app_debug = true）时，才会落盘。

runtime/ 目录需由 Web 服务器用户（如 www-data、nginx）有写权限，否则日志静默失败
首次访问时若目录不存在，TP 会尝试自动创建；但若父目录不可写（比如 runtime 所在磁盘满或挂载为只读），则完全不生成日志文件
日志按天分文件，如 runtime/log/20240520.log，不是单个大文件滚动

日志内容看不懂？格式字段含义与时间戳问题

默认日志每行以 [日期时间] [级别] [模块] 内容 开头，例如：[2024-05-20 14:22:31] [error] [app] SQLSTATE[HY000] [2002] Connection refused。

方括号里的日期是 PHP date('Y-m-d H:i:s') 输出，不是 UTC，而是服务器本地时区；若服务器时区设错（如系统为 CST 但 PHP 误配为 UTC），会导致日志时间比实际晚/早 8 小时，排查时容易误判时间线
级别字段（error、info、sql）取决于调用 Log::error() 或框架内部判断，sql 日志需开启 'log' => ['sql' => true]
模块名（如 app、core）来自日志上下文，但自定义命令行任务中若没显式设置，可能显示为 console 或空

查不到日志？常见静默失败原因

日志“没生成”或“有内容但看不到”，大概率不是配置漏了，而是以下几处卡住了：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

runtime/ 目录权限不对，Linux 下用 ls -ld runtime 看属主和权限，常见错误是属主为 root，Web 进程无法写入
log.max_files 设得太小（如 10），旧日志被轮转删除，而你正好看的是已被删的日期文件
使用 Swoole 或 Workerman 时，runtime/ 路径可能被多进程共享冲突，导致部分进程写失败（尤其在 reload 后）
TP6 中若启用了 think-swoole 扩展，日志默认走 Swoole 的异步写，但若未正确安装 swoole 扩展，会退化为同步写，此时若 opcache 开启且未刷新，可能缓存了旧的 log 配置

想快速定位某次请求？用 trace_id 或手动加标识

TP 自身不带全局 trace_id，但你可以通过中间件在日志前缀里注入唯一标识：

// app/middleware/LogTrace.php
public function handle($request, \Closure $next)
{
    $traceId = uniqid('req_', true);
    \think\Log::setLevel(\think\Log::INFO);
    \think\Log::info("REQ_START {$traceId} " . $request->url(true));
    $response = $next($request);
    \think\Log::info("REQ_END {$traceId}");
    return $response;
}