Tandoor Recipes 图片上传问题的分析与解决方案

问题现象

在 Tandoor Recipes 1.5.33 至 1.5.34 版本中，部分用户突然无法上传图片。症状表现为：

1. 无论是通过网页还是移动客户端都无法上传图片
2. 已存在的图片文件名格式为 UUID 形式（如 c8e0e843-760e-4757-8df6-2d3e5f2c0e99_18.jpg）
3. 新上传的图片保留了原始文件名而非转换为 UUID 格式
4. 文件权限发生变化：旧图片属于 www-data 组，新图片属于 tandoor 组

根本原因分析

经过排查，该问题主要与以下因素相关：

1. 权限配置问题：Django 工作进程无法访问新上传的图片文件，导致重命名和加载过程失败
2. Nginx 配置缺失：在 Docker 环境中，默认配置不再包含 Nginx 服务，导致媒体文件无法被正确访问
3. DEBUG 模式变更：新版本中 DEBUG 默认设置为 0，开发服务器不再提供媒体文件服务

解决方案

对于非 Docker 环境

1. 检查服务器文件系统权限：

   • 确保媒体目录（通常为 /media）对 Django 工作进程可写
   • 推荐权限设置为用户 tandoor，组 www-data
   • 使用 chown 和 chmod 命令修正权限

2. 检查 Django 日志：

   • 启用 DEBUG 模式查看详细错误信息
   • 在配置文件中设置 DEBUG=1

对于 Docker 环境

1. 添加 Nginx 服务：

   • 修改 docker-compose.yml 文件，添加 Nginx 服务配置
   • 确保 Nginx 能正确代理媒体文件请求

2. 或者启用 Gunicorn 媒体服务：

   • 在配置中设置 SERVE_MEDIA=true
   • 这将允许 Gunicorn 直接提供媒体文件服务

最佳实践建议

1. 部署环境标准化：

   • 生产环境建议使用 Nginx 作为反向代理
   • 确保所有服务使用相同的用户/组权限

2. 升级注意事项：

   • 升级前备份配置和媒体文件
   • 检查版本变更日志，特别是关于权限和媒体服务的变更

3. 故障排查步骤：

   • 首先检查文件系统权限
   • 然后检查服务日志
   • 最后验证网络配置

总结

Tandoor Recipes 的图片上传问题通常源于权限配置或服务架构变更。通过正确配置文件权限、确保媒体服务可用，以及合理设置调试模式，可以有效解决这类问题。对于 Docker 用户，特别需要注意容器化部署时的服务完整性，确保所有必要的组件（如 Nginx）都已正确配置。