ThinkPHP 8 定时任务异常不进全局异常处理器，需在 execute() 中手动 try-catch 并用 Log::channel('file')->error() 记录堆栈；CLI 日志需单独配置且避免 Log::init() 覆盖；crontab 调用须用绝对路径并控制 trace 深度。
ThinkPHP 8 定时任务执行失败却看不到报错堆栈？不是代码没写错，而是异常根本没被捕获、日志没落盘、甚至命令都没真正注册——这三处任一出问题，你只会看到 crontab 日志里一句“Command finished with error code 1”，然后卡在原地排查。
定时任务异常默认不进全局 Handler
TP8 的 think schedule:run 是命令行入口，走的是 Console 内核，**不经过 HTTP 异常处理链**。你在 app/exception.php 或 config/app.php 配的 exception_handle 对定时任务完全无效。
- 所有定时命令中的异常（如数据库连接失败、文件读取权限错误、JSON 解析异常）都由 PHP 原生未捕获机制兜底，最终只输出错误码或空白 stderr
- 想看到堆栈？必须在命令类的
execute()方法里手动 try-catch，并显式记录 - 示例写法：
protected function execute(Input $input, Output $output): int {<br> try {<br> // 你的业务逻辑<br> } catch (\Throwable $e) {<br> \think\facade\Log::error('Cron task failed', [<br> 'message' => $e->getMessage(),<br> 'file' => $e->getFile(),<br> 'line' => $e->getLine(),<br> 'trace' => array_slice($e->getTrace(), 0, 6)<br> ]);<br> $output->writeln('<error>Task failed: ' . $e->getMessage() . '</error>');<br> return self::FAILURE;<br> }<br> return self::SUCCESS;<br>}
日志通道必须单独为 CLI 环境配置
线上环境 display_errors=Off，而 CLI 默认不加载 web 日志配置——哪怕你 config/log.php 里设了 level => ['error']，定时任务也大概率写不进 runtime/log/error/。
- 确认
config/log.php中'default' => 'file'生效，且channels.file.type是'File' - CLI 场景下，
Log::init()很可能被误调用并覆盖了默认处理器（尤其在app.php或common.php里），导致日志静默丢弃 - 安全做法：不在命令中调用
Log::init()，改用Log::channel('file')->error(...)直接写入 - 验证方式：在
execute()开头加一行Log::channel('file')->info('cron started');，再跑一次php think schedule:run，立刻检查runtime/log/是否生成新日志
crontab 调用时堆栈被截断的常见原因
即使你写了 try-catch 并调用了 Log::error()，实际 crontab 执行时仍可能只记到 message，没有 trace 或只有前几行——这不是框架限制，而是 shell 环境变量和资源限制导致。
立即学习“PHP免费学习笔记（深入）”；
- crontab 默认
PATH极简，不包含 PHP 可执行路径，建议写绝对路径：* * * * * /usr/bin/php /var/www/your-project/think schedule:run >> /dev/null 2>&1 - 堆栈过长触发内存限制：用
array_slice($e->getTrace(), 0, 8)控制深度，避免日志写崩或 MySQL TEXT 字段截断 - 敏感字段泄露风险：若异常来自数据库（如
DataNotFoundException或含SQLSTATE），记得过滤$_ENV、$_SERVER['HTTP_AUTHORIZATION']等上下文，别直接json_encode($e->getTraceAsString()) - 异步写更稳：把日志写入操作包一层
pcntl_fork()或交由队列（如 Redis + worker），避免主流程阻塞
快速验证是否真有堆栈落地
别靠猜，用三步实锤：
- 在命令类
execute()中抛一个明确异常：throw new \Exception('test cron stack trace'); - 手动运行：
APP_ENV=production php think schedule:run -v（注意加-v看 verbose 输出） - 立即查日志：
tail -n 20 runtime/log/error/error-$(date +%Y-%m-%d).log，确认内容含file、line、trace三项完整信息
不复杂但容易忽略
