Docker部署ols-docker-env运行WordPress慢偶发503错误如何解决

上来把php.ini的memory_limit调到12G完全是无效操作，这个场景下根本不是PHP内存不足导致的问题，乱调反而可能让PHP进程无限制占满宿主机内存，触发系统OOM杀进程，加重503报错。之前XAMPP运行更快是因为XAMPP直接跑在宿主机原生环境，没有Docker虚拟化层的默认配置坑、IO损耗问题，按以下步骤调整即可恢复到和XAMPP接近的速度：

1. 优先解决文件挂载IO瓶颈（90%同类问题的核心诱因） #

• 如果你用的是Windows/macOS版本的Docker Desktop，默认绑定挂载宿主机目录的跨系统IO性能比原生磁盘读写差10-20倍，WordPress运行时要读取成百上千个主题、插件、核心文件，直接导致单页加载卡5秒以上
• 修复操作：把站点程序目录、wp-content目录、数据库数据目录改成Docker命名卷挂载，不要直接用宿主机本地路径绑定；Windows用户把项目目录加入杀毒软件、Windows Defender的扫描排除列表，同时加入Docker Desktop的文件共享信任目录，关闭WSL2后端的自动文件一致性实时扫描
• 性能校验：进入容器执行以下命令测磁盘直接写入速度，结果低于100MB/s就说明IO问题没解决

  dd if=/dev/zero of=/var/www/html/test.io bs=1M count=1024 oflag=direct
  

2. 调整OpenLiteSpeed的LSAPI进程配置（解决偶发503） #

• ols-docker-env默认的PHP进程配置阈值极低，初始仅启动1-2个LSAPI进程，本地开发开调试、WooCommerce插件较多时请求直接排队超时，返回503
• 进入容器编辑/usr/local/lsws/conf/httpd_config.conf，找到lsapi配置段替换为以下参数：

  lsapi {
    maxConns 20
    env PHP_LSAPI_CHILDREN=20
    initTimeout 60
    procSoftLimit 20
    procHardLimit 25
  }
  

• 调整完不要直接重启容器，进入容器执行/usr/local/lsws/bin/lswsctrl restart重载OpenLiteSpeed配置，避免容器启动时把配置重置为默认值

3. 关闭开发环境下的无效性能损耗项 #

• 本地开发环境直接关闭OpenLiteSpeed的全页缓存、静态资源强缓存规则，避免开发时反复命中旧缓存，额外增加清缓存操作的耗时
• 编辑容器内php.ini，调整OPcache配置兼顾热加载和性能：opcache.validate_timestamps=1、opcache.revalidate_freq=0；如果装了Xdebug，把xdebug.start_with_request设为trigger，不要默认给所有请求开Xdebug调试，单请求会多耗2-3秒
• 不要让宿主机杀毒软件实时扫描Docker数据卷目录，尤其是数据库的持久化目录，数据库随机读写被杀毒拦截会直接导致请求卡顿数秒

4. 校验Docker基础资源配额 #

• 打开Docker Desktop设置，检查分配给Docker的资源：CPU核数至少给到物理核数的一半，内存至少分配4G-8G即可，不需要给PHP单独分配12G内存，单PHP进程给到256M-512M完全足够本地开发使用

调整完可以用浏览器开发者工具看网络请求的TTFB（首字节时间），本地开发环境正常TTFB应该稳定在200-500ms区间，超过1s就说明还有配置项没调到位。

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