Docker化SuiteCRM 8.6重建缓存时无法创建Doctrine Proxy目录求助

问题描述 #

通过UI重建缓存时，频繁触发致命错误：

PHP Fatal error: Uncaught RuntimeException: Unable to create the Doctrine Proxy directory "/bitnami/suitecrm/cache/prod/doctrine/orm/Proxies"

场景：基于Bitnami官方镜像Docker化部署的全新SuiteCRM 8.6，仅在使用Docker绑定挂载（bind mount）时必现该问题，不挂载目录则运行正常。

已验证信息 #

• UI触发的缓存重建操作由www-data用户执行，挂载目录的文件归属已设置为www-data:www-data
• 排除权限配置错误，问题根源指向绑定挂载与SuiteCRM（Symfony底层）的目录创建逻辑冲突

可行解决方案 #

1. 宿主机预创建目录并设置权限 #

在宿主机上提前生成所需目录结构，确保权限匹配容器内用户：

mkdir -p ./cache/prod/doctrine/orm/Proxies
chown -R www-data:www-data ./cache
chmod -R 755 ./cache

完成后再通过docker-compose.yml正常挂载该目录。

2. 改用Docker管理卷替代绑定挂载 #

放弃绑定挂载，使用Docker原生卷让容器自行处理目录权限与生命周期：
修改docker-compose.yml的挂载配置：

services:
  suitecrm:
    # 保留原有镜像、端口等配置
    volumes:
      - suitecrm_cache:/bitnami/suitecrm/cache
      # 其他需要挂载的目录（如custom、modules）可单独配置卷
      - suitecrm_custom:/bitnami/suitecrm/custom

volumes:
  suitecrm_cache:
  suitecrm_custom:

3. 自定义容器启动脚本自动修复权限 #

编写启动脚本，在容器启动时自动创建代理目录并修正权限：

1. 在Dockerfile中添加脚本复制与执行权限配置：

FROM bitnami/suitecrm:8.6
COPY start.sh /opt/bitnami/scripts/suitecrm/
RUN chmod +x /opt/bitnami/scripts/suitecrm/start.sh

2. 创建start.sh脚本文件：

#!/bin/bash
# 预创建Doctrine代理目录并设置权限
mkdir -p /bitnami/suitecrm/cache/prod/doctrine/orm/Proxies
chown -R www-data:www-data /bitnami/suitecrm/cache
chmod -R 755 /bitnami/suitecrm/cache
# 执行官方默认启动流程
exec /opt/bitnami/scripts/suitecrm/entrypoint.sh /opt/bitnami/scripts/suitecrm/run.sh

4. 修改Symfony配置更换代理目录路径 #

将Doctrine代理目录指向容器内非挂载的临时路径，避免绑定挂载的权限限制：
编辑SuiteCRM的config/packages/doctrine.yaml文件：

doctrine:
  orm:
    proxy_dir: '/tmp/suitecrm_proxies'
    proxy_namespace: 'Proxies'

注意：临时目录会在容器重启后清空，每次重启后需重新重建缓存。

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