PHP 8.1 后台白屏需分五步排查：先强制显示错误，再用 php -l 检查语法，确认 Web 根目录指向 public/admin 子目录，查看 PHP 错误日志定位底层问题，最后排除 BOM 和不可见字符。
PHP 8.1 网站后台打开后一片空白，既无 HTML 内容也无错误提示，说明脚本执行在早期阶段就被中断，且错误信息被静默屏蔽——这不是页面没写内容，而是 PHP 根本没走到输出那一步。
第一步：强制让错误显示出来
在后台入口文件（如 admin/index.php 或 public/index.php）最顶部、任何其他代码或空白行之前，插入以下三行：
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
这三行必须紧贴文件开头，不能有空格、空行、BOM 或 UTF-8 编码杂质，否则会触发“Headers already sent”并导致白屏。如果加完刷新仍空白，说明连这三行都没执行成功——问题出在更底层，比如语法解析失败或文件编码异常。
立即学习“PHP免费学习笔记（深入）”；
第二步：用命令行直击语法解析层
打开终端，进入网站根目录，运行：
php -l admin/index.php
注意把路径换成你实际的后台入口文件。PHP 8.1 对语法更严格，常见报错包括：使用了已被移除的函数（如 mysql_*）、短数组语法 [] 误写成 [,]、match 表达式缺 default 分支、或参数类型声明与调用不匹配。若返回 Errors parsing admin/index.php，就按提示行号逐行检查——别跳过第 1 行，BOM 或隐藏字符常藏在那里。
第三步：确认 Web 根目录指向正确（ThinkPHP/Laravel/自建后台通用）
PHP 8.1 环境下，多数现代框架要求 Web 服务器根目录必须精确指向 public/ 或 admin/ 子目录，而非整个项目根。
方法一（宝塔用户）：
网站 → 对应站点 → 设置 → 根目录 → 改为 /www/wwwroot/your-site/admin（或 /public）→ 保存 → 重启 PHP。
方法二（Nginx 手动配置）：
检查 server 块中 root 指令是否指向了正确的子目录，例如：root /www/wwwroot/your-site/admin;；同时确认 location ~ \.php$ 块内 fastcgi_param SCRIPT_FILENAME 路径拼接正确，否则 PHP-FPM 会找不到入口文件。
【关键陷阱】 若 root 仍指向项目根（含 vendor/、app/、config/ 的那层），则自动加载器无法定位类，直接抛出 Fatal error: Uncaught Error: Class 'think\App' not found，但因 display_errors 未生效而显示为空白。
第四步：查 PHP 错误日志，定位“连 ini_set 都没跑”的情况
当上述三步都无效时，说明错误发生在 PHP 解析器加载文件前——比如文件权限拒绝读取、php.ini 中 log_errors = Off 且 error_log 路径不可写、或扩展缺失导致模块初始化失败。
① 运行 php --ini 查看正在使用的 php.ini 路径；
② 打开该文件，确认以下三项已启用：
log_errors = On
error_log = /var/log/php_errors.log（Linux）或 C:\php\logs\php_error.log（Windows）
error_reporting = E_ALL
③ 检查 error_log 文件路径是否存在，且 Web 服务器用户（如 www、nginx、apache）有写入权限；
④ 访问空白后台页面后，立刻用 tail -f /var/log/php_errors.log 监控实时日志，看到类似 PHP Parse error: syntax error, unexpected token "}" in /www/wwwroot/xxx/admin/index.php on line 47 就可精准修复。
第五步：排除 BOM 和不可见字符干扰
用 VS Code 打开后台入口文件，在右下角查看当前编码。如果显示 “UTF-8 with BOM”，立即点击它 → 选择 “Save with Encoding” → “UTF-8”。
Windows 记事本保存的 PHP 文件几乎必带 BOM，它会在
命令行快速清除（Linux/macOS）：
sed -i '1s/^\xEF\xBB\xBF//' admin/index.php
