真实原因是PHP进程用户（如www-data）无权在phpMyAdmin根目录下创建config子目录，因目录属主为root且权限755、挂载选项限制（noexec）、或SELinux/AppArmor拦截导致mkdir失败。
phpMyAdmin Setup 页面提示“无法写入 config 目录”的真实原因
不是 setup 脚本坏了，而是它根本没权限在 phpmyadmin 根目录下创建或写入 config 文件夹。setup 脚本运行时以 php 进程用户（如 www-data、apache 或 nginx）身份执行，该用户必须对 phpmyadmin 安装路径有**写权限**——但默认情况下，绝大多数生产环境都禁用了这一权限。
- 常见错误现象：
https://yoursite.com/phpmyadmin/setup/打开后显示 “phpMyAdmin 的根文件夹下创建 文档中所述的网站服务器可以写入的 config 文件夹”，且点击“Save”无反应或报错 500 - setup 脚本不会尝试写入
config.inc.php本身，而是先检查并试图在 phpMyAdmin 根目录下创建config/子目录（用于暂存编辑后的配置），再把生成的config.inc.php写进去 - 如果 phpMyAdmin 是通过包管理器（如 apt、yum）或宝塔面板安装的，其根目录通常属主为
root，且权限为 755，www-data用户无权在其下新建目录 - 某些容器镜像（如官方
phpmyadmin/phpmyadmin）压根没挂载可写卷到 phpMyAdmin 根路径，mkdir config必然失败
为什么 chmod 777 config 不起作用？
因为 config 目录还不存在——setup 脚本第一步就是 mkdir，失败就卡住，根本不会走到后续 chmod 步骤。强行手动创建 config 后仍报错，大概率是权限或属主不对。
- 手动创建后必须确保：目录存在 + 属主为 PHP 进程用户（如
sudo chown www-data:www-data config）+ 权限为 755（sudo chmod 755 config） - 不要设成 777：phpMyAdmin 在加载时会主动拒绝读取权限过于宽松的配置文件，即使
config/可写，最终生成的config.inc.php若权限是 666 或 646，也会触发 “配置文件权限错误” - 若用宝塔面板，注意其 PHP 运行用户默认是
www，不是www-data；用ps aux | grep php-fpm确认实际用户再 chown
setup 脚本写入失败的隐藏障碍
即使目录存在、权限正确、属主匹配，仍可能失败——问题出在文件系统挂载选项或安全模块上。
- 检查挂载参数：
mount | grep "$(dirname $(readlink -f /path/to/phpmyadmin))"，若输出含noexec、nosuid或noatime（后者不影响），尤其是noexec会导致 PHP 无法在该分区创建并 require 编译后的临时文件 - SELinux 启用时（RHEL/CentOS 默认开启），即使
ls -l显示权限正常，audit.log中也可能有avc: denied记录；临时验证：setenforce 0，再试 setup；永久修复：chcon -t httpd_sys_rw_content_t /path/to/phpmyadmin/config - AppArmor（Ubuntu 默认）同样拦截，检查
/etc/apparmor.d/usr.sbin.apache2或对应 profile 是否允许写入该路径 - 容器环境中，若 phpMyAdmin 目录挂载为只读（
ro），或未挂载额外卷到/etc/phpmyadmin或自定义 config 路径，则 setup 必败
绕过 setup、直接配好 config.inc.php 的实操路径
生产环境根本不该启用 setup 目录，所以最稳妥的做法是跳过它，手动配置。关键不是“怎么让 setup 工作”，而是“怎么让它彻底不用工作”。
- 复制
config.sample.inc.php到 phpMyAdmin 根目录，重命名为config.inc.php - 编辑该文件，至少设置：
$cfg['Servers'][$i]['host'] = '127.0.0.1';（避免 socket 解析失败）、$cfg['Servers'][$i]['auth_type'] = 'cookie';、$cfg['blowfish_secret'] = '随机46字符字符串'; - 确保
config.inc.php权限为 644、属主为 PHP 进程用户（如www-data:www-data） - 删掉整个
setup/目录，并按规范在 Web 服务器层屏蔽访问（Apache 用<Directory>，Nginx 用location = /phpmyadmin/setup）——这步漏掉，等于留个后门
真正容易被忽略的点：setup 脚本失败往往不是单一权限问题，而是属主 + 挂载选项 + SELinux/AppArmor 三者叠加的结果；查日志比反复 chmod 更有效，tail -f /var/log/apache2/error.log 或 journalctl -u php-fpm -f 里通常有明确的 Permission denied 或 Operation not permitted 提示。
立即学习“PHP免费学习笔记（深入）”；
