tp5.1+默认不自动加载app/helper.php等助手函数文件，需在composer.json中配置"files": ["app/helper.php"]并执行composer dump-autoload，否则调用时必报call to undefined function。
助手函数未加载导致 Call to undefined function
TP5.1+ 版本默认不自动加载 app/helper.php 或 app/common.php 中定义的函数，哪怕文件存在、函数写对了，调用时仍会报 Call to undefined function。根本原因不是语法错，而是 Composer 的 autoloader 根本没扫到这个文件。
- 在
composer.json的"autoload"下添加："files": ["app/helper.php"]（或你实际放函数的路径） - 改完必须执行
composer dump-autoload，否则修改无效 - 别把函数塞进
thinkphp/helper.php或runtime/目录——这些路径不在 Composer 扫描范围内 - 如果函数定义在
app/common.php，也要同样加进autoload.files，不能依赖“框架自动识别”
队列任务里调不到自定义函数
队列进程走的是 PHP CLI 模式，不经过 HTTP 生命周期，app/common.php 或 app/helper.php 不会被自动引入，config() 也返回 null，函数直接不可用。
- 最稳妥的做法：在 Job 类的
handle()方法开头手动引入：include_once APP_PATH . 'common.php'; - 避免在
__construct()中引入——队列反序列化时可能尚未初始化常量（如APP_PATH） - 不要在 Job 类里硬编码配置值，容易漏同步；优先用
include+ 函数封装，而非复制粘贴 - 若使用
db()等助手函数，注意它们内部可能依赖应用初始化，队列中需确保think\App已启动（通常需手动App::init()，但更推荐用原生 PDO 或重写轻量访问逻辑）
toArray() 报错 on array 是数据集类型错配
常见于 Db::table()->select() 后直接链式调用 toArray()，错误信息是 Call to a member function toArray() on array。这不是函数不存在，而是返回值已经是数组，不是 Collection 对象。
- 检查
config/database.php中的'resultset_type'配置项 - 若设为
'array'，查询结果就是 PHP 数组，不能再调toArray()；应改为'collection'才支持该方法 - 临时兼容写法：
is_object($data) && method_exists($data, 'toArray') ? $data->toArray() : $data - 注意：模型查询默认返回 Collection，但原生 Db 查询受此配置全局影响，别只看文档示例忽略本地配置
自定义异常处理 render 方法不生效
写了自定义 ExceptionHandler 类，render() 方法却没被调用，或者抛出 “Type error: Argument 1 must be instance of think\Exception” —— 很大概率是命名空间引用错了。
-
render()方法签名必须接收 PHP 原生Exception，不是think\Exception（后者是 TP 封装类，且已废弃） - 正确写法：
use Exception;，然后public function render(Exception $e) - 确认
config/app.php中'exception_handle'指向的类路径完全正确，且类文件可被自动加载（同样要进 Composer autoload） - 开发阶段可加日志验证是否进入 render：
file_put_contents(RUNTIME_PATH.'debug.log', print_r($e, 1), FILE_APPEND);
