Drupal9+CiviCRM环境下CKEditor5无法保存图片求助

1. 验证CiviCRM文件系统配置 #

• 进入CiviCRM后台，路径：Administer > System Settings > Directories，确认[civicrm.files]的实际物理路径和URL是否正确，尤其要核对persist/contribute/images的完整路径与服务器上的目录是否完全一致。
• 检查Administer > System Settings > Resource URLs中的Image Upload URL和Image Upload Path是否匹配上述目录，确保配置值无拼写错误（手动上传的图片能访问，说明URL路径本身有效，但需确认后台配置是否指向正确位置）。

2. 深入检查目录权限与系统访问控制 #

• 虽然目标目录权限为www-data:www-data 775，但需确认所有父目录（如[civicrm.files]/persist/、[civicrm.files]/）的权限是否为www-data:www-data且至少具备755权限，确保PHP进程能遍历到目标目录。
• Ubuntu 22默认启用AppArmor，检查是否限制了PHP进程的写入权限：
  • 执行命令sudo aa-status查看AppArmor状态，若存在PHP相关的profile，检查是否允许写入目标目录。
  • 临时关闭AppArmor测试：sudo systemctl stop apparmor，再尝试上传图片，若成功则需调整AppArmor规则，将目标目录添加到允许写入列表。

3. 检查PHP配置限制 #

• 打开PHP 8.1的php.ini文件，确认以下配置：
  • upload_max_filesize、post_max_size是否足够（建议设置为8M以上，匹配你上传的图片大小）。
  • open_basedir是否限制了PHP写入目标目录，若有则需将[civicrm.files]/persist/contribute/images添加到open_basedir的允许路径中。
• 修改配置后重启PHP服务：sudo systemctl restart php8.1-fpm（若使用FPM）或对应的Apache PHP模块服务。

4. 查看日志捕获隐藏错误 #

• 在CiviCRM后台开启调试：Administer > System Settings > Debugging and Error Handling，勾选Debugging和Display Backtrace，再次尝试上传图片，查看是否有直接报错信息。
• 查看Drupal日志：Reports > Recent Log Messages，搜索包含civicrm或upload的条目，排查未捕获的错误。
• 查看服务器PHP错误日志（通常路径为/var/log/php8.1-fpm.log或/var/log/apache2/error.log），寻找上传过程中的写入失败提示、权限拒绝信息。

5. 验证全局文件上传功能 #

• 尝试通过CiviCRM其他功能上传文件（比如联系人头像、贡献表单附件），若同样失败，说明是全局文件上传问题，需聚焦CiviCRM文件系统配置或服务器权限；若其他功能正常，则问题集中在邮件模板编辑器的上传逻辑。

6. 修复文件系统SELinux上下文（若适用） #

• 若服务器启用了SELinux，即使目录权限正确，上下文错误也会导致写入失败：
  • 执行sudo ls -Z [civicrm.files]/persist/contribute/images查看目录上下文，对比手动上传图片的上下文是否一致。
  • 若不一致，修复上下文：sudo chcon -R system_u:object_r:httpd_sys_rw_content_t:s0 [civicrm.files]/persist/contribute/images/

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