为何声明函数时出现“Fatal error: Cannot redeclare function...”错误？

云原生阿岚

2026-6-19

解决“Cannot redeclare function”错误的排查方案

检查文件重复加载：把代码里的include/require换成include_once/require_once，避免同一个文件被多次引入导致函数重复声明，这是最常见的触发原因。
全局搜索函数名：用IDE的全局搜索功能，或者在终端执行grep -r "function 你的函数名" ./（Linux/macOS环境），遍历整个项目目录，找出所有匹配的函数声明——说不定它藏在某个你没留意的公共配置文件、工具库文件里。
排查命名空间冲突：如果项目用了命名空间，要么是你的函数没放在正确的命名空间下，导致和全局或其他命名空间的函数重名；要么是调用时没指定命名空间。确认函数的命名空间上下文，调整声明或调用方式。
避免和内置/扩展函数重名：先确认你的函数名是不是和PHP内置函数、已安装扩展的函数撞了。可以在声明函数前加判断，避免重复定义：
```
if (!function_exists('your_target_function')) {
    function your_target_function() {
        // 函数逻辑
    }
}
```
要是真撞名了，直接换个函数名更省心。
清理OPcache缓存：如果开启了OPcache，旧的函数定义可能还留在缓存里。重启PHP服务，或者临时关闭OPcache（修改php.ini的opcache_enable=0），再测试看看。
检查框架/第三方库：如果你用了框架或者第三方依赖，它们可能已经声明了同名函数。去翻框架文档，或者搜索依赖库的源码目录，确认是否存在冲突。