require()报错本质是PHP找不到目标文件，需优先排查路径、文件、权限和加载时机；如报Failed opening required './ThinkPHP/ThinkPHP.php'，应改用__DIR__拼接绝对路径、确认目录存在且大小写正确、TP5+需引入vendor/autoload.php并确保composer install成功、检查open_basedir限制。
require() 报错本质是 PHP 找不到目标文件，不是 ThinkPHP 框架本身坏了——优先查路径、文件、权限、加载时机这四件事。
require() 找不到 ThinkPHP.php 怎么办
错误通常长这样：Fatal error: require(): Failed opening required './ThinkPHP/ThinkPHP.php'。这不是框架问题，是入口文件路径写死了。
- 检查
index.php里require语句是否用了相对路径，比如require './ThinkPHP/ThinkPHP.php';—— 改成require __DIR__ . '/ThinkPHP/ThinkPHP.php'; - 确认
ThinkPHP目录真实存在，且大小写完全一致（Linux 下thinkphp和ThinkPHP是两个目录） - 如果用的是 ThinkPHP 5+，入口文件不该 require
ThinkPHP.php，而是vendor/autoload.php；检查composer install是否执行成功，vendor/autoload.php是否可读 - 服务器上
open_basedir如果限制了路径范围，__DIR__生成的绝对路径也可能被拦住，临时注释 php.ini 中的open_basedir测试是否为此原因
include() Filename cannot be empty 错误怎么定位
这个报错表面看是 include() 传了空字符串，但真正源头往往在配置或环境变量里。堆栈指向 think\exception\Handle.php 第 184 行，只是“最后一公里”，不是病因。
- 检查
.env文件里有没有空值配置，比如APP_DEBUG=后面没填内容，或VIEW_PATH=被清空了 - 查看最近是否修改过
config/app.php或数据库配置，尤其是涉及路径拼接的字段（如template.view_path） - 在
public/index.php开头加一行：var_dump($_SERVER['SCRIPT_FILENAME'], __DIR__);，确认当前运行目录和入口位置是否符合预期 - 如果是部署后才出问题，重点对比本地和服务器的
DOCUMENT_ROOT和虚拟主机配置，路径计算依赖__DIR__，而它取决于 Web 服务器如何解析请求
模板 include 动态参数导致失败
模板中写 {include file="$tpl"}，结果报 Filename cannot be empty 或直接白屏，是因为 $tpl 变量没传进来、为空，或值非法（含路径穿越字符）。
立即学习“PHP免费学习笔记（深入）”；
- 不要在模板里拼接路径：
{include file="./Public/" . $name . ".html"}是高危写法，框架不会过滤，容易触发文件包含漏洞 - 改用
R()方法调用控制器逻辑：{:R('Common/header', ['data' => $data])}，确保数据先经过 PHP 层处理再输出 - 若必须动态包含，提前在控制器里校验并赋默认值：
$this->assign('header_tpl', $request->param('header', 'default'));，模板中只写{include file="$header_tpl"} - ThinkPHP 6 已移除模板内
{php}标签，任何试图在模板里执行include的逻辑都会失效或报错，这类需求必须前置到控制器
Runtime 缓存干扰导致 require 失败
改了配置或模板，重启服务后仍报旧路径错误，大概率是缓存没清干净。ThinkPHP 的模板编译缓存分两层，只删 Runtime/Cache 不够。
- 必须同时删除
Runtime/Cache和Runtime/Temp两个目录，否则哈希映射残留，框架仍会加载已损坏的编译文件 - 开发时建议关掉模板缓存：
'cache' => false写进config/view.php，避免缓存掩盖真实路径问题 - TP6 的模板缓存默认写入
runtime/view/，该目录需 web 用户有写权限；Swoole 或 CLI 模式下，注意用户身份是否一致（如 nginx 用户写入，root 用户跑命令可能读不到） - 别信
php artisan view:clear这类 Laravel 命令，ThinkPHP 没这个功能，手动删目录才是唯一可靠方式
最常被忽略的是：错误信息里那个“找不到的文件名”，往往不是你写的代码路径，而是框架内部根据配置拼出来的路径。盯住报错行号前几行的变量 dump，比反复检查 require 语句本身更有效。
