升级ThinkPHP后自定义助手函数报错需将函数移至app/helper.php，配置composer.json autoload files并执行composer dump-autoload，删除所有手动require，确保无重复定义且函数不依赖未初始化的门面。
升级ThinkPHP后自定义助手函数调用报错Call to undefined function，说明框架已不再自动加载旧路径下的函数文件，必须按新版本规范重新注册并刷新自动加载机制。
确认当前ThinkPHP版本对应路径
TP6及以上版本只认app/helper.php这一处——不是app/common.php，不是app/extend/helper.php，也不是thinkphp/helper.php。如果函数原来放在app/common.php或public/helper.php，现在必须剪切到app/helper.php，且该文件必须真实存在、无命名空间、无return语句。
【文件名和路径大小写敏感：必须是小写app，小写helper.php】
补全composer autoload配置
打开项目根目录的composer.json，在"autoload" → "files"数组中加入"app/helper.php"：
立即学习“PHP免费学习笔记（深入）”；
若原配置为空，直接添加完整段落：
```json
"autoload": {
"files": ["app/helper.php"]
}
```
改完后立刻执行：composer dump-autoload。不执行这一步，函数永远无法被识别。
注意：如果之前删过autoload配置，或手动加过require APP_PATH.'helper.php'，必须彻底删除这些代码——它们会与Composer加载冲突，导致重复定义或加载失败。
排查重复定义问题
全局搜索你的函数名（例如my_format_date），确认是否在多个文件中被定义。常见雷区：
① config/app.php里配置了'extra_file' => [APP_PATH.'common.php']，而common.php又require了helper.php；
② 命令行脚本里手动require __DIR__.'/app/helper.php'，但Composer已加载一遍；
③ 执行过composer dump-autoload -o把helper.php打进classmap，框架再走自己的Loader就会二次加载。
所有include/require务必换成include_once/require_once，尤其在config/、public/下的手动引入。
验证函数是否生效
在控制器任意方法中写一行：dump(function_exists('your_helper_func'));。
返回true说明函数已加载成功；返回false说明路径、autoload或文件内容仍有问题。
这一步操作起来很简单，直接把文件拖进去就行。但注意：如果函数里调用了Db::table()却报Call to a member function set() on null，不是函数错了，而是Db门面依赖的容器实例尚未初始化——助手函数在中间件前就可能被执行，此时Session/Config都未准备好，应避免在函数内直接使用框架门面。
