ThinkPHP7路径错误主因是PHP找不到文件，需用__DIR__确保绝对路径、检查大小写、启用日志定位真实路径、严格遵循PSR-4命名规范，并避免手写相对路径。
require() 或 include() 报 Failed opening required 错误
这不是 ThinkPHP7 框架坏了，是 PHP 根本没找到你要加载的文件。入口文件（如 public/index.php）里写的 require 路径错了，尤其常见于硬编码相对路径。
- 把
require './thinkphp/base.php';改成require __DIR__ . '/thinkphp/base.php';——__DIR__保证从当前文件出发算绝对路径，不依赖工作目录 - 确认
thinkphp/目录真实存在，且大小写完全一致（Linux 下ThinkPHP和thinkphp是两个不同目录） - TP7 默认不再用
base.php入口，而是走 Composer 自动加载；检查是否漏了composer install，或vendor/autoload.php是否可读 - 若服务器启用了
open_basedir，__DIR__拼出的路径可能被拦截；临时注释 php.ini 中该配置测试是否为此原因
模板中 {include file="xxx"} 报 Filename cannot be empty 或 Template not exists
ThinkPHP7 的模板引擎对 file 属性不做归一化处理，传空、含非法字符、路径拼错都会直接失败，且不报具体缺失路径——得靠日志反推。
- 在
config/view.php中确认'view_path'配置以./开头（如'./app/view/'），漏掉会变成系统根目录下的绝对路径 - 在控制器中调用
$this->fetch('index')时，ThinkPHP7 默认找的是app/view/index.html，不是app/view/index/index.html；若你模板放在子目录，显式写全路径：$this->fetch('index/index') - 模板内避免动态拼接：
{include file="./Public/" . $name . ".html"}是高危写法；改用{:widget('header', ['data' => $data])}或先在控制器校验$tpl是否非空、是否合法 - 开启日志：在
config/log.php中设'level' => ['error', 'notice']，然后看日志里Template not exists:后面打印出的完整路径，它才是框架真正去查的位置
Class not found 错误指向控制器或中间件
TP7 严格遵循 PSR-4，类找不到几乎全是命名空间与物理路径不匹配，和“代码写错”无关。
- 检查
app/controller/IndexController.php的命名空间是否为namespace app\controller;（注意是反斜杠\，不是正斜杠或斜杠混用） - 类名必须与文件名一致：
IndexController类 → 文件必须叫IndexController.php，不能是indexcontroller.php或index.php - 运行
composer dump-autoload -o强刷自动加载映射，别只清缓存 - 若用了自定义中间件，在
app/middleware.php中注册时，类名要带完整命名空间，例如app\middleware\CheckAuth::class，不能只写CheckAuth::class
Windows 开发、Linux 部署后模板/路由突然 404
Windows 文件系统不区分大小写，但 TP7 加载器底层用 realpath() 和 basename() 做精确匹配，部署到 Linux 就暴露路径大小写问题。
立即学习“PHP免费学习笔记（深入）”；
- 所有控制器、模型、视图文件名必须和类名/变量名大小写完全一致：类
Admin\UserController→ 路径app/controller/Admin/UserController.php - 模板引用统一小写：
{include file="common/header"}，而不是{include file="Common/Header"} - 业务代码中禁用
file_exists('./config/db.php')这类手写路径；改用is_file(App::getAppPath() . 'config' . DS . 'db.php')，is_file()比file_exists()更早暴露大小写错误 - CI/CD 流程中加一步校验：
find app/ -name "*[A-Z]*.php" | grep -v "vendor\|runtime"，提前发现大小写混用文件
__DIR__ 没用对、view_path 配置漏 ./、模板里又手拼了相对路径，三者一碰就失效。最容易被忽略的是 is_file() 和 file_exists() 的行为差异，后者在大小写不敏感系统下会“假装成功”，掩盖真实问题。 
