根本原因是PHP 8.2+与phpMyAdmin 5.2.x不兼容，需启用mysqli、mbstring等扩展并确保Apache加载对应PHP模块，优先使用phpMyAdmin 5.3+/6.x官方ARM包，正确配置权限、别名及MySQL/PHP内存参数。
phpMyAdmin 在 Raspberry Pi 上打不开登录页，显示 500 错误
根本原因是默认 php 版本（如 php 8.2+）与 phpmyadmin 旧版（如 5.2.x）不兼容，尤其在较新 raspbian/debian bookworm 系统上，mysqli 扩展行为变更 + mbstring 缺失会直接触发 500。不是配置写错了，是底层扩展没加载或版本越界。
- 先确认 PHP 版本：
php -v；若 ≥ 8.1，优先装 phpMyAdmin 5.3.0+ 或 6.x（官方 ARM 支持已完善） - 必须启用的扩展：
sudo phpenmod mysqli mbstring zip openssl（缺mbstring是最常见 500 原因） - 检查 Apache 是否加载 PHP 模块：
a2query -m php，没输出就运行sudo a2enmod php8.2（按实际版本号替换） - 别用
apt install phpmyadmin默认源——它常绑死旧版，改用官网 .tar.gz 包手动部署更可控
用 apt 安装后 phpMyAdmin 链接 404，/phpmyadmin 路径不存在
Debian 系统（含 Raspberry Pi OS）从 phpMyAdmin 5.3 开始，默认不再自动创建 Apache 别名，/etc/apache2/conf-enabled/phpmyadmin.conf 文件可能压根没生成，或指向了错误路径。
- 手动创建软链接：
sudo ln -s /usr/share/phpmyadmin /var/www/html/phpmyadmin（前提是已用 apt 安装） - 更稳妥的做法：下载官方 ARM 兼容包解压到
/var/www/html/phpmyadmin，然后确保目录属主是www-data：sudo chown -R www-data:www-data /var/www/html/phpmyadmin - Apache 必须允许 .htaccess 覆盖：
<Directory /var/www/html/phpmyadmin> AllowOverride All </Directory>要写进对应虚拟主机或000-default.conf - 别忽略
config.inc.php权限：必须设为 644，且不能是 root 所有，否则 Apache 拒绝读取
登录时提示 “The mysqli extension is missing”，但 php -m 显示已加载
这是典型的 PHP-FPM 与 CLI/模块不一致问题：你用 php -m 查的是 CLI SAPI 的扩展列表，而 Apache 实际跑的是 FPM 或 mod_php，它们的 php.ini 文件路径不同，扩展需分别启用。
- 查 Apache 使用的 PHP 配置路径：
phpinfo()页面里找 “Loaded Configuration File”，或命令sudo apache2ctl -M | grep php看加载的是 mod_php 还是 proxy_fcgi（FPM） - 如果是 FPM，启用扩展要改
/etc/php/8.2/fpm/php.ini和/etc/php/8.2/cli/php.ini两处，再重启服务：sudo systemctl restart php8.2-fpm apache2 - 验证是否生效：
sudo -u www-data php -m | grep mysqli（模拟 Apache 用户执行） - Raspberry Pi 上常见陷阱：安装了
php-mysql包，但新版 Debian 已改名为php-mysqlnd，装错就白忙
ARM 架构下 phpMyAdmin 响应慢、卡顿，尤其打开大表时
不是 phpMyAdmin 本身问题，而是默认配置在树莓派这类内存受限设备上过于激进，MySQL 和 PHP 缓存策略没适配 ARM 小内存场景。
- 调低 MySQL 的
innodb_buffer_pool_size：树莓派 4GB 内存建议设为256M（默认可能 1G），改/etc/mysql/mariadb.conf.d/50-server.cnf - PHP 中关闭
opcache.enable_cli=1（CLI 模式无需 OPcache），并限制opcache.memory_consumption=64（单位 MB） - phpMyAdmin 自身关掉“自动计算表行数”：
$cfg['Servers'][$i]['DisableIS'] = true;加进config.inc.php，避免SELECT COUNT(*)卡死小表 - 别开“服务器端排序”：
$cfg['Order'] = 'SMART';改成'NONE'，让浏览器端处理，省掉一次全量数据传输
ARM 上最易被跳过的点：MySQL 默认日志模式是 ROW，配合 phpMyAdmin 的结构同步操作会产生大量 I/O，建议开发环境临时切回 STATEMENT，否则 SD 卡寿命和响应速度都会明显下降
立即学习“PHP免费学习笔记（深入）”；
