PHP 8.1下phpMyAdmin无法登录主因是config.inc.php缺失、$cfg['blowfish_secret']为空或不合规（须32–46字符），或auth_type与运行模式不匹配；需确保文件存在、权限正确、密钥合规、认证模式适配apache2handler/FPM，且禁用已废弃配置。
phpMyAdmin 在 PHP 8.1 下无法登录或报错，绝大多数情况不是版本不兼容，而是 config.inc.php 缺失、$cfg['blowfish_secret'] 为空，或认证方式与 PHP 运行模式不匹配。
config.inc.php 文件必须存在且位置正确
Ubuntu 包管理安装（如 apt install phpmyadmin）通常会自动生成 /etc/phpmyadmin/config.inc.php；但如果你是手动解压部署（比如放到 /var/www/html/phpmyadmin），这个文件根本不会自动出现。
常见错误现象：访问页面直接跳转到 setup 界面、提示 “Cannot load or save configuration”，或登录后反复重定向到登录页。
- 先检查是否存在：
ls -l /usr/share/phpmyadmin/config.inc.php或你实际部署路径下的config.inc.php - 不存在就复制模板：
cp /usr/share/phpmyadmin/config.sample.inc.php /usr/share/phpmyadmin/config.inc.php - 注意权限：确保 Apache 用户（通常是
www-data）能读取该文件，chown root:www-data /usr/share/phpmyadmin/config.inc.php && chmod 640 /usr/share/phpmyadmin/config.inc.php
$cfg['blowfish_secret'] 必须非空且长度合规
PHP 8.1 下 auth_type = 'cookie' 严格依赖 $cfg['blowfish_secret']。留空、只填空格、或超过 46 字符都会导致登录失败或 500 错误。
立即学习“PHP免费学习笔记（深入）”；
错误示例：$cfg['blowfish_secret'] = ''; 或 $cfg['blowfish_secret'] = 'a';
- 生成合规密钥（32–46 字符，仅含 ASCII 可见字符）：
openssl rand -base64 32 | tr -d "=+/" | cut -c1-46 - 编辑
config.inc.php，找到并替换该行：$cfg['blowfish_secret'] = '你的新密钥'; - Mac 用户注意：保存时用 Unix 换行符（
\n），别用\r，否则 PHP 8.1 会解析失败
auth_type 和 PHP 运行模式必须匹配
PHP 8.1 常见运行模式是 apache2handler（mod_php）或 fpm-fcgi（PHP-FPM）。不同模式对 auth_type 的支持有差异：
-
auth_type = 'cookie'：安全推荐，但要求$cfg['blowfish_secret']正确，且 PHP session 能正常写入（检查session.save_path目录权限） -
auth_type = 'config'：仅限本地调试，需明文写死 MySQL 用户密码，PHP 8.1 下仍可用，但会触发安全警告 -
auth_type = 'http'：Apache Basic Auth，需启用mod_auth_basic并在虚拟主机中配置Require valid-user，PHP 8.1 下兼容性稳定 - 避免用
auth_type = 'signon'或'ldap'，除非你明确配置了对应后端，否则必然 500
PHP 8.1 特定兼容性补丁
部分老配置（尤其从 PHP 7.x 升级而来）可能引用已废弃函数或参数，导致白屏或 Notice 报错：
- 删除或注释掉
$cfg['MCryptPass']——mcrypt扩展在 PHP 7.2+ 已移除，PHP 8.1 完全不可用 - 确认未启用
register_globals或magic_quotes_gpc相关设置 —— 这些在 PHP 5.4+ 就被废弃，PHP 8.1 会直接报错 - 如果用了
$cfg['Servers'][$i]['ssl'] = true，确保系统已安装php8.1-curl和ca-certificates，否则连接远程 MySQL 会超时
最易被忽略的是：PHP 8.1 默认禁用 allow_url_fopen，而某些插件或主题加载逻辑依赖它 —— 若发现样式/JS 加载失败，检查 php.ini 中是否显式设为 On，并在 Apache 配置里用 php_admin_flag allow_url_fopen On 覆盖（仅限可信环境）。
