Directus升级后图片加载失败的排查与解决

问题背景

在使用Directus 10.13.1升级到10.13.2版本后，用户遇到了所有图片都无法加载的问题，系统返回FORBIDDEN错误。即使进一步升级到10.13.4版本，问题依然存在。数据库和文件目录中确认文件存在，且权限设置正确。

问题表现

1. 新上传的图片可以短暂显示，但随后出现FORBIDDEN错误
2. 重启Docker容器后，所有图片都无法加载
3. 文件系统检查确认文件实际存在

根本原因分析

通过检查用户的Docker Compose配置，发现了一个关键配置错误：

• 容器挂载点设置为/directus/upload
• 但Directus配置中指定存储路径为./uploads

这种不一致导致：

1. 上传的文件实际上被写入到容器临时存储而非挂载的持久化卷
2. 容器重启后，临时存储中的文件被清除
3. 系统尝试访问不存在的文件导致FORBIDDEN错误

解决方案

修正Docker Compose配置中的路径一致性：

1. 确保STORAGE_LOCAL_ROOT配置与挂载点一致
2. 推荐使用绝对路径而非相对路径
3. 示例修正后的配置片段：

volumes:
  - /path/to/uploads:/directus/uploads
environment:
  STORAGE_LOCAL_ROOT: '/directus/uploads'

经验总结

1. 路径一致性：在容器化部署中，确保挂载点与应用程序配置的存储路径完全一致
2. 持久化存储：重要文件必须挂载到宿主机持久化存储，避免容器重启导致数据丢失
3. 配置验证：升级后应验证所有路径和配置项是否保持正确
4. 日志检查：出现问题时，检查容器日志可帮助快速定位配置错误

预防措施

1. 在升级前备份配置文件和重要数据
2. 使用配置管理工具维护环境变量和挂载点
3. 实施变更前的测试流程，特别是路径相关的配置变更
4. 考虑使用配置验证工具检查路径一致性

通过这次案例，我们认识到在容器化环境中路径配置的重要性，特别是涉及文件存储的场景。正确的配置不仅能解决问题，还能预防潜在的数据丢失风险。