Cannot redeclare function 错误源于多个文件重复 require 同一函数定义文件，常见于 ThinkPHP 中 common.php/helper.php 被多次加载、extend 目录下函数文件被反复 import、或 Composer 与 TP 自动加载机制冲突；应统一入口、改用 require_once、清理缓存并检查 autoload 配置。
为什么 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 的地方。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 全局搜索该函数名（
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，也别分散在五六个地方赌自己记得住谁先谁后。
