phpMyAdmin 连不上 MariaDB 首先检查 mysqli 扩展是否启用，确认 php.ini 启用 extension=mysqli、phpinfo() 显示 MariaDB 客户端版本，并正确配置 auth_type、host 及 default_authentication_plugin 为 mysql_native_password。
phpMyAdmin 连不上 MariaDB：先看 mysqli 驱动是否启用
phpmyadmin 从 5.0 开始默认只支持 mysqli，彻底弃用旧的 mysql 扩展。mariadb 10.2+ 虽然兼容 mysql 协议，但若 php 编译时没带上 mysqli，或 php.ini 里注释了 extension=mysqli，就会报 #2002 cannot log in to the mysql server 或空白登录页。
- 运行
php -m | grep mysqli确认模块已加载 - 检查
php.ini中是否存在extension=mysqli（不是mysqlnd，也不是pdo_mysql） - Apache/Nginx 重启后，用
phpinfo()页面搜索 “mysqli” 确认“Client API library version” 显示的是 MariaDB 版本号（如 10.6.12），而非 “mysqlnd” —— 这说明连接走的是原生 MariaDB 客户端库，更稳
config.inc.php 里 $cfg['Servers'][$i]['auth_type'] 别乱设为 config
本地开发用 config 认证看似省事，但一旦 MariaDB 启用了 unix_socket 插件（默认在 Debian/Ubuntu 的 mariadb-server 包中启用），config 模式会绕过密码校验直接尝试 socket 连接，结果常报 #1698 Access denied for user 'root'@'localhost'。
- 开发环境优先用
cookie或http认证，让 phpMyAdmin 显式传用户名/密码 - 若坚持用
config，必须确保 MariaDB 用户是通过mysql_native_password插件认证：ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('xxx'); -
$cfg['Servers'][$i]['host']别写127.0.0.1和localhost混用 —— 前者走 TCP，后者可能走 Unix socket，行为不一致
MariaDB 10.4+ 的 default_authentication_plugin 会让 phpMyAdmin 登录失败
MariaDB 10.4 默认把 default_authentication_plugin 设为 unix_socket，而 phpMyAdmin 的 mysqli 驱动不支持该插件认证流程，连上去就断。
- 临时解决：启动 MariaDB 时加
--default-authentication-plugin=mysql_native_password - 永久解决：在
/etc/mysql/mariadb.conf.d/50-server.cnf的[mysqld]段下加一行：default_authentication_plugin = mysql_native_password - 改完必须重启
mariadb服务，且对已有用户需重新执行ALTER USER ... IDENTIFIED VIA mysql_native_password，仅改配置不生效
phpMyAdmin 5.2.x + MariaDB 11.0：注意 information_schema 权限变化
MariaDB 11.0 默认禁用部分 information_schema 表的非特权访问（如 INNODB_METRICS），而 phpMyAdmin 5.2 默认会尝试查这些表做状态展示，导致页面报错或卡在“Loading…”。
- 给 phpMyAdmin 使用的数据库用户加权限：
GRANT SELECT ON `information_schema`.* TO 'pma_user'@'localhost'; - 或在
config.inc.php中关掉相关功能：$cfg['ShowDatabasesCommand'] = false;、$cfg['ShowStats'] = false; - 别试图降级 phpMyAdmin —— 5.1 对 MariaDB 11.0 兼容更差，会直接无法加载导航栏
版本匹配不是“能连上就行”，MariaDB 小版本更新常悄悄改认证链路或元数据暴露策略，驱动层感知不到，错误却出在 phpMyAdmin 渲染阶段。最稳的做法：MariaDB 主版本确定后，只用对应 phpMyAdmin 官方标注支持的最新小版本，别贪新。
立即学习“PHP免费学习笔记（深入）”；
