ThinkPHP 5.1白屏根因是.env解析异常、类加载失败、模板标签错误或门面调用不当；需依次检查.env特殊字符加引号、校验命名空间大小写与路径一致性、清空runtime缓存、修正模板闭合标签、改用think\facade\Xxx调用核心类。
ThinkPHP 5.1项目突然白屏、后台打不开、日志里反复出现Fatal error，你正卡在上线前最后一刻，服务器监控已告警——这不是配置没生效，而是框架在关键路径上拿到了空值或错类，必须立刻定位并切断错误源头。
定位“include(): Filename cannot be empty”根因
第一步：确认错误是否由.env文件解析异常引发
打开项目根目录下的.env文件，逐行检查所有以=赋值的行，重点扫描值中是否含#、@、$、空格等未加引号的特殊字符。例如DATABASE_PASSWORD=myPass#word123会被phpdotenv截断为myPass，后续拼接路径时直接变为空字符串。
第二步：对含特殊字符的配置值强制加双引号
把DATABASE_PASSWORD=myPass#word123改为DATABASE_PASSWORD="myPass#word123"，APP_NAME=My App改为APP_NAME="My App"。注意：单引号无效，必须用双引号包裹整段值，否则phpdotenv仍会按规则解析注释与变量。
第三步：清空运行时缓存并重启请求
删除runtime/目录下全部子目录（包括cache/、log/、temp/），不要只删某一项；然后刷新页面。这一步必须做，因为错误可能已固化在缓存编译文件中，仅改.env不生效。
立即学习“PHP免费学习笔记（深入）”；
修复“Class not found”类加载失败
方法一：检查命名空间与文件路径大小写是否严格一致
Linux服务器对大小写敏感，而Windows开发环境不敏感。若控制器类文件名为BirdExpress.php，其命名空间必须为app\api\controller\BirdExpress，且调用处use app\api\controller\BirdExpress;中的controller必须全小写。任何一处大写（如Controller）都会导致类找不到。
方法二：验证Composer自动加载是否注册成功
执行composer dump-autoload命令，然后打开vendor/composer/autoload_psr4.php，搜索app\和think\前缀，确认对应路径指向application/和thinkphp/真实目录。若缺失，说明composer未正确识别应用目录结构。
方法三：排查编辑器自动引入的非法命名空间
常见陷阱：在控制器中输入Route::后，IDE自动补全插入use think\console\command\optimize\Route;。该类仅用于命令行优化，不可在HTTP请求中使用。【立即删除该use语句】，否则会触发Call to undefined method ... Route::group()致命错误。
解决模板标签编译失败（Tag not closed）
第一步：暴力清除视图缓存
进入runtime/view/目录，删除该目录下所有文件和子目录。不要尝试手动找某个.tpl.php文件——ThinkPHP 5.1生成的缓存文件名含哈希值，人工无法穷举，漏删一个就会继续报错。
第二步：关闭模板缓存进行实时调试
打开config/view.php，将'cache' => true改为'cache' => false。这能确保每次请求都重新编译模板，让语法错误立刻暴露，而不是隐藏在旧缓存里。
第三步：校验闭合标签嵌套与属性名准确性
检查所有{volist}、{foreach}、{if}标签是否成对出现；特别注意嵌套时内层name不能与外层重复，例如外层{volist name="list"}，内层必须写成{volist name="list.children"}；属性名必须为英文且严格匹配，key不能写成index，empty不能写成else。
绕过“Call to undefined method”方法不存在错误
遇到Call to undefined method think\Cache::get()，立刻停手——ThinkPHP 5.1中think\Cache是抽象基类，不能直接调用实例方法。正确写法是使用门面类：use think\facade\Cache;，然后调用Cache::get('key')。同理，Log、Db、Validate等均需通过think\facade\Xxx引入。
若报错Call to undefined method app\index\controller\Login::fetch()，说明控制器未正确继承基类。打开app/index/controller/Login.php，确认第一行class Login extends Controller中的Controller已正确引入：use think\Controller;。缺少该use语句，PHP将认为Controller是当前命名空间下的类，自然找不到fetch()方法。
