应先执行php -v确认当前CLI版本为PHP 8.1.x，再检查框架是否支持（如ThinkPHP 6.1+、WordPress 6.0+），接着启用错误显示捕获Deprecated或Fatal error，最后分层验证数据库连接、必需扩展（mysqli/pdo_mysql/mbstring）、MySQL用户IPv4权限及session存储配置。
确认PHP版本与后台程序的兼容性
打开终端，执行 php -v，确认当前运行的确实是 PHP 8.1.x（如 8.1.30），而非系统残留的 7.4 或 8.0 版本；【若输出不是 8.1 开头，后续所有排查都无效】。
检查网站根目录下是否存在 composer.json 或框架标识文件（如 think、wp-includes/version.php），比对官方文档明确声明支持 PHP 8.1 的最低版本——例如 ThinkPHP 6.1+、WordPress 6.0+、PHPCMS v3.0+ 才完整兼容，旧版 PHPCMS v2.0 或 DedeCMS v5.7 直接运行在 PHP 8.1 下会因 mysql_connect() 被移除而登录页白屏或报 Fatal error。
快速捕获致命错误：启用 PHP 错误显示
编辑项目根目录下的 .user.ini（Apache 环境则改 php.ini 或 .htaccess），将以下两行设为开启：
display_errors = Onerror_reporting = E_ALL
保存后重启 PHP-FPM（sudo systemctl restart php8.1-fpm）并刷新登录页——如果页面突然显示 “Deprecated: Function create_function() is deprecated” 或 “Fatal error: Uncaught TypeError”，说明问题出在代码层，不是配置或密码；【这一步不操作，90% 的 PHP 8.1 登录失败会卡在黑盒里瞎猜】。
立即学习“PHP免费学习笔记（深入）”；
分层验证数据库连接是否存活
第一步：用命令行直连数据库，验证凭据有效性
执行 mysql -u{数据库用户} -p -h{主机地址} {数据库名}，输入密码。若拒绝访问，说明 database.php 或 wp-config.php 中的用户名、密码、主机（不能写 localhost，要写 127.0.0.1 或 socket 路径）有误。
第二步：检查 PHP 8.1 是否禁用了必需扩展
运行 php -m | grep -E 'mysqli|pdo_mysql|mbstring'，缺任何一个模块都会导致登录逻辑中断——尤其是 mbstring 缺失时，PHPCMS 和部分国产 CMS 的密码校验函数直接返回 false，界面只提示“密码错误”。
第三步：确认 MySQL 用户权限未被 PHP 8.1 的严格模式拦截
登录 MySQL 后执行：SELECT host, user FROM mysql.user WHERE user = '{你的用户名}';，若 host 显示为 ::1（IPv6 回环），而 PHP 连接时用的是 localhost，就会因解析失败静默断开；此时需用 CREATE USER '{用户}'@'127.0.0.1' IDENTIFIED BY '{密码}'; 新建 IPv4 用户并赋权。
绕过登录逻辑直查 Session 与 Cookie 行为
方法一：浏览器开发者工具 → Application → Cookies，查看是否有 PHPSESSID 字段生成。如果没有，说明 session_start() 在 PHP 8.1 下因 open_basedir 限制或 tmp 目录不可写而失败——检查 php.ini 中 session.save_path 指向的路径是否存在且权限为 733（Web 用户可写）。
方法二：临时在登录入口文件（如 /admin/index.php 开头）插入：<?php error_log('Session status: '.session_status()); ?>
然后查看 /var/log/php-fpm/www-error.log，若日志中出现 “session_start(): Failed to initialize storage module”，即证实 session 存储层崩了。
方法三：禁用登录验证码与 IP 限制中间件（如 ThinkPHP 的 throttle、PHPCMS 的 v9_session 表校验），直接注释掉相关 if 判断块，再试登录——若成功，说明是频率控制逻辑在 PHP 8.1 下类型推断异常，需升级对应中间件版本。
