绝大多数fatal error: call to undefined method错误源于三类环境契约断裂：控制器未继承think\controller、模型未继承think\model、或gd扩展缺失freetype支持；需依次检查继承关系、命名空间及php扩展配置。
ThinkPHP 5.1 报 Fatal error: Call to undefined method，绝大多数情况不是框架坏了，而是调用链上某个关键环节断了——要么类没继承、要么扩展没开、要么命名空间写错，三者占全部报错的 90% 以上。
控制器里调用 assign() 或 fetch() 报错
这是新手最常踩的坑：控制器类没继承 think\Controller，却直接用了视图相关方法。
-
assign()、fetch()、redirect()都是think\Controller提供的，不是 PHP 原生函数，也不是随便写个 class 就能用 - 检查控制器文件开头是否有
use think\Controller;，且类定义是class Index extends Controller - 如果写了
use think\controller\Controller（带controller子命名空间），会加载错误类，导致方法不可见 - 别手动 new 一个控制器实例去调用这些方法——它们依赖框架的初始化流程，只应在请求生命周期内由路由调度后调用
模型里调用 where() 报错
模型类没继承 think\Model，或误把 Db 查询器当模型用了。
- 确认模型文件（如
app\model\User.php）中是否包含use think\Model;和class User extends Model - 如果类里写了
use think\db\Query或压根没extends，那它只是个普通 PHP 类，where()根本不存在 -
Db::table('user')->where(...)是合法的，但这是查询构造器用法；一旦你写成(new User)->where(...)，就必须确保User是真正继承Model的模型类
验证码报 Call to undefined function think\captcha\imagettftext()
这不是 ThinkPHP 的 bug，是 PHP 的 gd 扩展缺 FreeType 支持。
- 运行
php -i | grep -i -A 20 "^gd"，重点看FreeType Support是否为enabled - 如果显示
disabled或压根没这一行，说明 GD 编译时没带字体渲染能力，imagettftext()函数根本没注册 - 宝塔、oneinstack 等面板默认安装的 GD 常砍掉 FreeType；自己编译 PHP 时需加
--with-freetype-dir参数 - 临时绕过办法：改验证码配置，把
useZh设为false，禁用中文，改用纯数字/英文+基础字体（但不解决根本问题）
Workerman 启动报 pcntl_signal() 未定义
PHP 编译时没启用 pcntl 扩展，而 Workerman 的 gateway 模式强依赖它。
-
pcntl在 Windows 下不可用，Linux/macOS 下也常被一键脚本禁用（因涉及进程控制，部分共享主机禁止） - 运行
php -m | grep pcntl，无输出即未启用 - 若用源码编译，需在
./configure时加上--enable-pcntl；若用包管理器（如 apt/yum），安装php-pcntl包并重启 PHP-FPM 或 Web 服务 - 注意：Docker 容器里如果 base 镜像精简，很可能默认不带
pcntl，需在 Dockerfile 中显式安装并启用
这类错误真正难排查的点不在代码本身，而在环境与框架约定之间的隐性契约——比如「控制器必须继承 Controller」「模型必须继承 Model」「GD 必须带 FreeType」「CLI 模式必须有 pcntl」。漏掉任意一环，错误信息都只会冷冰冰地告诉你“方法不存在”，不会提示你该去补哪块拼图。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
