使用wp-env运行WordPress时安装更新插件提示需FTP凭据的问题咨询

基于Docker架构的wp-env本地开发环境，默认未配置WordPress文件系统直连规则，且容器内的wp-content目录权限常无法匹配写入要求，才会跳出FTP凭据校验弹窗。这类校验逻辑是给非本地Docker部署的传统环境设计的，完全不适用于wp-env的容器化开发场景。目前该问题在Windows 10 + Node.js 14.15 环境下可稳定复现，其他版本的系统、Node搭配组合也有概率触发。

方法1：强制开启文件系统直连模式（最快解决） #

• 找到项目根目录下的wp-env.json配置文件
• 在配置的根层级补充如下配置参数，直接让WordPress跳过FTP校验逻辑：

"config": {
  "FS_METHOD": "direct"
}

• 保存文件后，依次执行wp-env stop、wp-env start重启环境，新配置会在WordPress初始化时自动生效

方法2：修正容器内目录写入权限 #

如果配置完FS_METHOD仍弹出FTP提示，基本是容器内的运行用户对wp-content目录没有写入权限：

• 终端执行命令进入wp-env自带的WordPress CLI容器：
  wp-env run cli bash
• 在容器交互终端中依次执行权限调整命令：

chown -R www-data:www-data /var/www/html/wp-content
find /var/www/html/wp-content -type d -exec chmod 755 {} \;
find /var/www/html/wp-content -type f -exec chmod 644 {} \;

• 输入exit退出容器终端，重试插件、主题的安装更新操作即可

Windows 10 + Node.js 14.15 专属排查项 #

这个特定版本组合下的wp-env存在已知的路径识别bug，容易额外触发权限判断异常：

• 项目存放路径不能包含中文、空格或特殊字符，否则会导致Docker卷挂载的权限映射失效
• 不要用管理员权限启动终端运行wp-env，会造成宿主机与容器内的用户身份错位，直接阻断目录写入权限
• 如果之前运行过其他旧版wp-env实例，先执行wp-env destroy清空所有旧环境缓存，再重新初始化开发环境

内容的提问来源于stack exchange，提问作者Thomas Higginbotham