phpMyAdmin 的 $cfg['Servers'][$i]['port'] 不生效，是因为当 host 字符串中已显式包含端口号（如 'localhost:3306'）时，phpMyAdmin 会自动忽略 port 配置项；若同时设置二者，还会导致连接地址重复拼接（如 localhost:3306:3306），引发认证失败或连接异常。
phpmyadmin 的 `$cfg['servers'][$i]['port']` 不生效，是因为当 `host` 字符串中已显式包含端口号（如 `'localhost:3306'`）时，phpmyadmin 会自动忽略 `port` 配置项；若同时设置二者，还会导致连接地址重复拼接（如 `localhost:3306:3306`），引发认证失败或连接异常。
在 Docker 环境或自定义部署中，常见误区是「既在 host 中硬编码端口，又单独配置 port」——这并非 phpMyAdmin 的 Bug，而是其明确的设计逻辑：host 字段若含 : 分隔符，系统即判定为完整 TCP 地址（host:port），此时 port 参数将被静默跳过。
✅ 正确配置原则：二选一，不可共存
| 场景 | 推荐写法 | 说明 |
|---|---|---|
| 使用默认端口（3306）且走本地 socket | $cfg['Servers'][$i]['host'] = 'localhost'; $cfg['Servers'][$i]['port'] = '';（或直接省略） |
localhost 触发 Unix socket 连接（更快更安全），无需指定端口；port 留空或不设，避免干扰 |
| 必须指定非默认端口（如 3307）或强制走 TCP | $cfg['Servers'][$i]['host'] = '127.0.0.1'; $cfg['Servers'][$i]['port'] = 3307; $cfg['Servers'][$i]['connect_type'] = 'tcp'; |
127.0.0.1 强制 TCP，port 生效；显式声明 connect_type 可提升兼容性 |
| ❌ 错误写法（导致端口重复） | $cfg['Servers'][$i]['host'] = 'localhost:3306'; $cfg['Servers'][$i]['port'] = 3306; |
解析后变为 localhost:3306:3306 → 连接拒绝，日志中常显示 Connection refused 或空白错误 |
? 关键提示：MySQL 8.0+ 默认认证插件为 caching_sha2_password，而 phpMyAdmin 4.9.x（你当前版本）对此支持有限。即使连接地址正确，仍可能因认证失败静默退出。务必同步执行：
ALTER USER 'admin'@'localhost' IDENTIFIED WITH mysql_native_password BY 'admin'; FLUSH PRIVILEGES;
? 针对你的 Docker 环境的修复建议
-
修正 config.inc.php 中的服务器配置块（替换原 if (!empty($dbname)) { ... } 内容）：
if (!empty($dbname)) { $cfg['Servers'][$i]['auth_type'] = 'cookie'; $cfg['Servers'][$i]['host'] = '127.0.0.1'; // ✅ 改用 127.0.0.1 而非 localhost $cfg['Servers'][$i]['port'] = !empty($dbport) ? (int)$dbport : 3306; $cfg['Servers'][$i]['connect_type'] = 'tcp'; // ✅ 显式声明 $cfg['Servers'][$i]['extension'] = 'mysqli'; $cfg['Servers'][$i]['user'] = $dbuser; $cfg['Servers'][$i]['password'] = $dbpass; // ... 其余 pma 库配置保持不变 } -
确保 MySQL 用户兼容旧版 phpMyAdmin（已在 init.sh 中添加，但需确认生效）：
# init.sh 中追加（或替换原有 GRANT） mysql -u root -e " ALTER USER 'admin'@'localhost' IDENTIFIED WITH mysql_native_password BY 'admin'; GRANT ALL PRIVILEGES ON *.* TO 'admin'@'localhost'; FLUSH PRIVILEGES; "
验证配置是否生效：
登录 phpMyAdmin 后，观察右上角显示的服务器信息——应为 127.0.0.1:3306（单端口），而非 localhost:3306:3306。若仍异常，检查 Apache 错误日志：tail -f /var/log/apache2/error.log，重点关注 mysqli::real_connect() 相关报错。
⚠️ 重要升级提醒（长期维护必读）
你当前使用的 phpMyAdmin 4.9.5 + PHP 7.4 + MySQL 8.0 组合已处于严重兼容风险区：
- phpMyAdmin 4.x 对 MySQL 8.0 的 authentication_string 字段、密码重用策略等新特性支持不完整；
- PHP 7.4 已于 2022 年结束生命周期，存在未修复安全漏洞；
- 官方明确要求：MySQL 8.0 必须搭配 phpMyAdmin ≥ 5.0（[参考知识库发布时间：2026年4月]）。
✅ 建议立即升级至 phpMyAdmin 5.2+（最新稳定版），并同步更新 PHP 至 8.1+。升级只需：
# 下载新版并解压覆盖（保留 config.inc.php） wget https://files.phpmyadmin.net/phpMyAdmin/5.2.1/phpMyAdmin-5.2.1-all-languages.tar.gz tar xzf phpMyAdmin-5.2.1-all-languages.tar.gz -C /usr/share/ mv /usr/share/phpMyAdmin-5.2.1-all-languages /usr/share/phpmyadmin
? 注意：切勿仅覆盖部分文件，必须整体替换目录，避免旧版 JS/CSS 引用残留导致界面错乱。
遵循以上配置逻辑与升级路径，即可彻底解决端口被忽略、重复拼接及认证失败问题，让 phpMyAdmin 在 Docker 环境中稳定、安全、高效运行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
