白屏是PHP执行中途终止，主因是mbstring/xml/zip/gd扩展缺失、Web服务器未正确解析PHP、或session路径权限不足；需用php -m验证四扩展、检查Web配置及session.save_path权限，并查PHP错误日志定位真因。
白屏不是安装失败，而是 PHP 执行中途被终止——常见于扩展缺失、配置错误或 session 权限异常，必须逐层验证运行时环境，不能只看安装日志。
检查 PHP 扩展是否全部启用
phpMyAdmin 5.x（Debian 12 默认）要求 mbstring、xml、zip、gd 四个扩展同时加载，缺一个就会在首页或登录页白屏，且不报错。
- 运行
php -m | grep -E 'mbstring|xml|zip|gd'，确认四者全部列出；漏掉任一模块，执行sudo apt install php-mbstring php-xml php-zip php-gd并重启 PHP-FPM（如sudo systemctl restart php8.2-fpm） - Debian 11/12 中，
php-zip容易被忽略——它不随php-cli自动安装，但 phpMyAdmin 启动时会调用ZipArchive类解析语言包，未加载直接 fatal error - 别信
phpinfo()页面显示“已启用”：有些扩展虽列在模块列表里，但实际因依赖缺失（如 libzip-dev 缺失）而无法初始化，需配合php -v看是否有PHP Warning: Module 'zip' already loaded类警告
验证 Web 服务器是否真正解析 PHP
访问 /phpmyadmin 返回空白页，可能根本没走到 PHP 层——Nginx/Apache 只是把 index.php 当静态文件下载，或返回 200 空内容。
- 先确认 Web 根目录下能跑 PHP：新建
/var/www/html/test.php，内容为<?php phpinfo(); ?>，用浏览器访问http://localhost/test.php。若失败，说明 PHP 解析链断裂，和 phpMyAdmin 无关 - Apache 用户检查
/etc/apache2/conf-enabled/phpmyadmin.conf是否存在且已启用：sudo a2enconf phpmyadmin+sudo systemctl reload apache2 - Nginx 用户必须手写
location ~ ^/phpmyadmin/(.+\.php)$块，且fastcgi_pass必须指向当前 PHP-FPM socket（如unix:/run/php/php8.2-fpm.sock），路径错一位就白屏
排查 session 存储权限与路径
phpMyAdmin 登录前需写 session 文件，默认路径是 /var/lib/php/sessions。若该目录不可写、磁盘满、或 SELinux/AppArmor 限制，就会静默失败，页面白屏无提示。
立即学习“PHP免费学习笔记（深入）”；
- 运行
ls -ld /var/lib/php/sessions，确认属主为www-data且有写权限（drwxr-xr-x不够，必须drwx-wx-wt或至少drwxrwxr-x） - 检查磁盘空间：
df -h /var/lib/php，/var分区满会导致 session 写入失败 - 临时测试：修改
/etc/php/8.2/fpm/php.ini中的session.save_path = /tmp，重启php8.2-fpm，若白屏消失，即锁定原路径权限问题
绕过前端直接查错误日志
白屏时浏览器看不到任何输出，但错误其实记在 PHP 或 Web 服务器日志里。别猜，直接翻日志。
- PHP 错误日志位置取决于配置：
php -i | grep "error_log"，常见路径是/var/log/php8.2-fpm.log或/var/log/apache2/error.log - 重点搜关键词：
PHP Fatal error、failed to open stream、Class 'ZipArchive' not found、session_start(): Failed to initialize storage module - 若日志为空，检查
php.ini中log_errors = On和error_reporting = E_ALL是否启用；Debian 默认可能关了display_errors，但必须开log_errors
最常被跳过的环节是 session 目录权限和 zip 扩展——它们不报错、不中断安装、也不出现在安装日志里，但足以让整个界面变成一张白纸。动手前先看日志，比重装快十倍。
