升级 PHP 后 phpMyAdmin 出现白屏，通常并非单纯的“兼容性问题”，而是由旧配置残留、缺失扩展或启动阶段静默崩溃所致——PHP 7.4+ 与 8.x 对扩展加载、错误报告机制及 BOM 处理更为严格，老环境中能侥幸通过的配置，升级后便直接中断输出。简单来说，问题不在于 PHP 不兼容，而是系统将报错信息隐藏了起来，你看到的结果仅是一片空白。
下面请按步骤逐一排查，切勿跳过，因为多数情况下都是多个问题共同导致的。
mysqli 扩展未启用是最常见的原因
自 phpMyAdmin 4.9 版本起，mysqli 成为强制依赖项，不再支持 mysql 或仅仅依赖 pdo_mysql。升级 PHP 后，原有的 extension=mysqli 配置可能失效——例如配置文件被覆盖，或扩展目录发生变化。如何验证？
- Linux（如 Ubuntu）：执行
php -m | grep mysqli，若无输出则表明未加载；可运行sudo phpenmod mysqli（Debian/Ubuntu）或检查/etc/php/*/mods-available/mysqli.ini是否已启用 - Windows：确认
php.ini中extension=php_mysqli.dll前的分号已移除，同时extension_dir指向真实 DLL 所在目录 - Docker：基础镜像（如
php:8.3-apache）默认不含mysqli，必须添加RUN docker-php-ext-install mysqli - 验证实际可用性：仅看
php -m输出不够，还需访问phpinfo()页面，搜索 “mysqli” 区块，确认存在“Client API library version”等运行时信息
这一步骤通常能解决半数以上的白屏问题。
php-gettext 扩展在 PHP 7+ 环境下已成为硬性依赖
在 Ubuntu 16.04+、Debian 系及大多数 PHP 7.0+ 环境中，php-gettext 不再属于可选组件——它负责多语言字符串处理，缺失会导致 phpMyAdmin 启动时解析失败并静默退出，页面完全空白。很多人在升级后忽略了此模块，结果反复排查也找不到根因。
- Debian/Ubuntu：运行
sudo apt install php-gettext，然后重启 Web 服务（sudo systemctl restart apache2或sudo systemctl restart php*-fpm） - CentOS/RHEL：安装
php-common（通常已包含 gettext），若仍白屏，检查extension=gettext.so是否在生效的php.ini中启用 - 别跳过验证：创建
test.php文件，内容为，返回bool(true)才说明配置正确
config.inc.php 语法错误或废弃配置引发 parse error
PHP 升级后解析器更严格，旧版 config.inc.php 中几个常见雷区会直接导致整个入口脚本崩溃，且由于错误显示被关闭，你仅能看到白页。最易踩坑的几个地方：
$cfg['blowfish_secret']为空或长度不足 32 字符：新版会报错，但因错误显示关闭，只留下白页- 使用了已移除的配置项，比如
$cfg['Servers'][$i]['auth_type'] = 'http'（5.2+ 已废弃） - 注释跨过了 PHP 开始标签：
/* 这类写法在 PHP 8.0+ 会解析失败 - 文件末尾有多余空格、BOM 或 UTF-8 BOM 头：用 VS Code 打开 → 右下角点击编码 → “Save with Encoding” → 选择 “UTF-8 without BOM”
- 快速验证：执行
php -l /path/to/phpmyadmin/config.inc.php，若有语法错误会明确提示具体行号
这三条命令比盲目猜测有效得多。
错误报告仍处于关闭状态，你根本看不到故障位置
升级 PHP 后，display_errors 和 error_reporting 很可能被重置为默认值（Off + E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED），导致致命错误发生时浏览器仅返回空响应。许多人在服务器上折腾半天，其实只要看一眼日志就能定位。
- 临时补救：在 phpMyAdmin 的
index.php顶部（后第一行）插入：error_reporting(E_ALL); ini_set('display_errors', '1'); ini_set('display_startup_errors', '1'); - 更稳妥的做法：修改生效的
php.ini。先通过phpinfo()查找 “Loaded Configuration File”，再编辑该文件，设置display_errors = On和error_reporting = E_ALL，最后重启 Web 服务（不是 reload） - 注意路径差异：Apache mod_php 与 PHP-FPM 加载的
php.ini路径不同，FPM 环境下通常位于/etc/php/*/fpm/php.ini，改错位置等于没改
真正棘手的并非单一问题，而是多个限制叠加：比如 mysqli 已加载但 php-gettext 缺失，或者 config.inc.php 语法正确但 blowfish_secret 为空字符串——PHP 解析完配置后，在初始化阶段才崩溃，此时连日志都可能不留痕迹。请务必按顺序逐项排除，切勿依靠猜测。
