tp5队列任务类中不能直接使用config()或helper函数，因cli环境不自动加载http生命周期的配置和common.php，需手动引入或传参处理。
队列任务类里不能直接用 config() 或 helper 函数
TP5 的 think-queue 是通过 CLI 启动的（比如 php think queue:work），它不加载 HTTP 请求生命周期中的配置和公共函数。所以你在 Job 类的 fire() 方法里调用 config('database.hostname') 或 dump()，大概率返回 null 或报 Call to undefined function。
- CLI 环境下
application/extra/下的配置不会自动载入，common.php也不会被引入 - Job 类是独立实例化执行的，不走控制器或中间件流程，所有依赖必须显式处理
- 常见错误现象：日志里看到
config() returns null、undefined function trace()、class not found（因命名空间未补全）
在 Job 类中安全使用自定义函数和配置的三种方式
推荐按优先级排序，避免硬编码或重复引入：
-
方式一（推荐）：在
fire()开头手动引入common.php并重载配置
在 Job 类的fire()方法第一行加：require_once __DIR__ . '/../../../application/common.php';
再手动加载你需要的配置文件（如config/database.php），或直接用Env::get()读环境变量 -
方式二：把关键配置抽成常量或静态属性写死在 Job 类里
适合变动极少的参数，比如 Redis 连接池名、邮件模板 ID、第三方 API key
例如：private const EMAIL_TEMPLATE_ID = 'tpl_202608'; -
方式三：通过
$data参数传入所需配置值
入队时就把config('mail.host')的结果作为字段塞进$data，Job 内部只做纯逻辑处理
缺点是配置变更需重启队列进程才生效，不适合动态值
push() 和 later() 入队时要注意类名格式
ThinkPHP5 的 think-queue 对类名解析很敏感，稍有偏差就会找不到类或方法：
- 类路径必须完整且带命名空间，比如
'app\jobs\SendEmailJob@handle'，不能写成SendEmailJob或app/jobs/SendEmailJob - 如果没指定方法，默认调用
fire()；若指定@handle，则必须存在该方法且签名匹配：public function handle(Job $job, $data) - 延迟队列用
Queue::later(60, ...)，不是delay()——delay()是旧版或误传，实际不存在这个方法 - 入队返回值为
null很可能是因为类不存在、命名空间拼错、或payload序列化失败（含 resource、闭包等）
调试时别只看控制台输出
CLI 模式下 echo、var_dump() 输出会刷屏但难定位，尤其多 worker 时容易串行。真正有效的调试手段是：
- 用
Log::write()或file_put_contents('./runtime/logs/queue_debug.log', ...)记录每一步 - 检查 Redis 中的
queues:default列表长度：redis-cli -h 127.0.0.1 -p 6379 LLEN queues:default - 确认
queue:work进程是否真在跑：ps aux | grep 'queue:work'，Windows 下用任务管理器查php.exe - 注意
reserved字段：如果任务卡在 reserved 状态超过timeout，说明消费者崩溃或没调用$job->delete()
config() 能用，其实不能；你以为 trace() 会打日志，其实它只是个空壳。每次改完 Job 类，务必用 CLI 手动触发一次 php think queue:work --once 验证全流程。
