ThinkPHP运行报Cannot redeclare function的类库加载冲突排查-ThinkPHP-PHP中文网

cannot redeclare function 错误源于多个文件重复 require 同一函数定义文件，常见于 thinkphp 中 common.php/helper.php 被多次加载、extend 目录下函数文件被反复 import、或 composer 与 tp 自动加载机制冲突；应统一入口、改用 require_once、清理缓存并检查 autoload 配置。

thinkphp运行报cannot redeclare function的类库加载冲突排查

为什么 `Cannot redeclare function` 总在 ThinkPHP 启动时冒出来

这不是 PHP 解析器抽风，而是多个文件试图用 require 或 include 重复载入同一个函数定义文件。ThinkPHP 的自动加载机制（尤其是 Loader::import() 或手动 require_once 混用）很容易触发这个错误——尤其当你在配置、行为、中间件或扩展类库里写了裸函数，又没做防重载保护。

常见诱因包括：

在 common.php 或 helper.php 中定义函数，但被多次 require（不是 require_once）
自定义的扩展类库目录里，有同名函数文件被不同入口反复加载
Composer 自动加载 + ThinkPHP 手动 Loader::addNamespace() 双重注册同一命名空间
在 app/common.php 和 public/index.php 里都 require 了同一个工具文件

怎么快速定位是哪个函数在“抢着声明”

错误信息末尾一般会带具体函数名，比如：Cannot redeclare my_format_date() (previously declared in /path/to/helper.php:12)。重点看括号里的路径和行号——那才是第一次声明的位置；而报错位置，往往是第二次 require 的地方。

实操建议：

全局搜索该函数名（my_format_date），确认它是否只在一处定义；如果搜出多处，立刻删掉冗余的
检查所有 require/include 语句，替换成 require_once 或 include_once，特别是 config/、extend/、public/ 下的手动引入
运行 php think clear 清空所有缓存（含类库映射），避免旧的自动加载规则干扰判断
临时在 thinkphp/library/think/Loader.php 的 loadClass() 方法开头加一行 echo $class . " -> " . $file . "\n";，观察重复加载路径（上线前务必删掉）

ThinkPHP 5.1+ 的 `helper.php` 加载机制陷阱

TP5.1 起默认通过 Loader::import('helper') 自动加载 app/helper.php，但如果你在 config/app.php 里又配了 'extra_file' => [APP_PATH.'common.php']，而 common.php 里也 require 了 helper.php，就必然冲突。

更隐蔽的是 Composer autoload：如果你用 composer dump-autoload -o 把 helper.php 打包进 classmap，TP 再走自己的 Loader 就会二次加载。

统一入口：只让 TP 加载 helper.php，删掉所有手动 require APP_PATH.'helper.php'
确认 composer.json 的 autoload.files 里没有包含 helper.php 或任何定义函数的文件
函数必须放在 app/helper.php 或 extend/ 下的独立文件中，且文件名与函数名无关——TP 不按文件名加载函数，只按路径扫描
若要用 Composer 管理辅助函数，改用 PSR-4 类封装，别裸写函数

自定义扩展类库（`extend/`）里的函数声明规范

extend/ 目录下允许放函数文件，但 ThinkPHP 默认不会自动加载它们——除非你显式调用 Loader::import() 或在配置里注册。很多人在这里埋雷：把 extend/utils/string.php 里写一堆函数，又在多个控制器里各自 Loader::import('utils.string')，结果每次 import 都重新 require。

所有 extend/ 下的函数文件，必须以 return function() {}; 或完整命名空间类方式组织，避免直接执行声明逻辑
改用 Loader::register() 注册一次，而不是在业务逻辑里反复 import
如果函数极少变动，直接塞进 app/helper.php，由框架统一加载一次即可
检查 extend/ 下是否有同名文件（如 string.php 和 String.php），Windows 不区分大小写但 Linux 会当两个文件加载

最麻烦的不是找不到冲突点，而是你以为改好了，结果某个行为（behavior）或服务提供者（service provider）悄悄又 require 了一次——这种加载链路藏得深，得盯着 debug_backtrace() 输出看调用栈。函数声明这事，宁可全收口到 helper.php，也别分散在五六个地方赌自己记得住谁先谁后。