容器化WordPress插件失效及页面访问异常问题求助

1. 统一容器运行用户与文件权限 #

两个核心问题大概率源于Nginx和WordPress容器的文件权限不匹配：

• Alpine版Nginx默认以nginx用户（UID 101）运行，而WordPress FPM Alpine版默认以www-data用户（UID 82）运行，共享卷./wp的文件归属会导致一方无法读取文件。

修复步骤： #

• 修改docker-compose.yaml，让Nginx容器以www-data用户运行：

  webserver:
    # 保留原有配置
    user: www-data
  

• 调整本地./wp目录的权限，匹配容器内www-data的UID/GID：

  sudo chown -R 82:82 ./wp
  

• 重启容器生效：

  docker-compose down && docker-compose up -d
  

2. 排查插件函数未定义错误 #

该错误通常是插件文件无法被PHP读取，或插件本身存在问题：

• 进入WordPress容器检查插件目录权限：

  docker exec -it wordpress ls -l /var/www/html/wp-content/plugins
  

  确保插件文件权限为644、目录权限为755，且所有者为www-data。
• 临时禁用所有插件排查：
  重命名插件目录，验证是否是插件导致的问题：

  docker exec -it wordpress mv /var/www/html/wp-content/plugins /var/www/html/wp-content/plugins-disabled
  

  若网站恢复正常，再逐个恢复插件定位问题。
• 开启WordPress debug日志定位具体错误：
  在./wp/wp-config.php中添加：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  

  查看./wp/wp-content/debug.log获取详细错误信息。

3. 验证Nginx配置正确性 #

检查Nginx错误日志，确认是否有配置或文件读取问题：

docker exec -it webserver tail -f /var/log/nginx/error.log

若存在Permission denied类错误，说明权限问题未彻底解决，需重新核对文件归属与容器用户设置。

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