Django tinymce生产环境无法上传新图片返回500错误求助

1. 优先排查media目录权限问题 #

这是最常见的原因：你当前的配置中Apache已经正确配置了media目录的访问规则，已存文件可以正常读取说明读权限正常，无法写入新文件90%是因为Apache运行用户（默认是www-data）对media目录没有写入权限，或者media目录本身不存在。
先确认目录存在，再执行以下命令修复权限：

# 确认media目录存在，不存在则创建
mkdir -p /home/omid/pypro/media
# 修改media目录所属用户组为Apache运行用户
sudo chown -R www-data:www-data /home/omid/pypro/media
# 赋予目录读写执行权限
sudo chmod -R 755 /home/omid/pypro/media

2. 修正配置文件路径问题 #

你当前贴出的settings.py中读取配置文件的路径是Mac系统下的本地路径：

with open('/Users/omidsoroush/Desktop/config/config.json') as config_file:

生产环境是Linux系统，不存在该路径，如果部署时没有修改这个路径，会直接触发服务报错返回500，需要修改为生产环境实际存放config.json的路径。

3. 修复文件名特殊字符兼容问题 #

如果上传的文件名包含中文、空格或特殊符号，生产环境系统编码不兼容时会触发文件写入失败。建议修改上传逻辑，对文件名进行重命名规避该问题，同时也能避免同名文件覆盖冲突，修改views.py的upload_image函数如下：

import os
import uuid # 新增uuid依赖导入
from django.conf import settings
from django.http import JsonResponse
from django.utils import timezone
from django.views.decorators.csrf import csrf_exempt

@csrf_exempt
def upload_image(request):
    if request.method == "POST":
        file_obj = request.FILES['file']
        file_name_suffix = file_obj.name.split(".")[-1].lower() # 统一转小写避免后缀大小写识别问题
        if file_name_suffix not in ["jpg", "png", "gif", "jpeg", ]:
            return JsonResponse({"message": "文件格式错误"})

        upload_time = timezone.now()
        path = os.path.join(
            settings.MEDIA_ROOT,
            'tinymce',
            str(upload_time.year),
            str(upload_time.month),
            str(upload_time.day)
        )
        # 路径不存在则创建
        if not os.path.exists(path):
            os.makedirs(path)
        # 用uuid生成唯一文件名
        new_file_name = f"{uuid.uuid4().hex}.{file_name_suffix}"
        file_path = os.path.join(path, new_file_name)
        file_url = f'{settings.MEDIA_URL}tinymce/{upload_time.year}/{upload_time.month}/{upload_time.day}/{new_file_name}'

        with open(file_path, 'wb+') as f:
            for chunk in file_obj.chunks():
                f.write(chunk)

        return JsonResponse({
            'message': '图片上传成功',
            'location': file_url
        })
    return JsonResponse({'detail': "请求方式错误"})

4. 生产环境DEBUG配置修正 #

你当前配置中DEBUG = True，生产环境必须关闭DEBUG避免泄露敏感信息，关闭后不需要担心media资源无法访问，因为你已经在Apache中配置了Alias /media的代理规则，不需要依赖Django的调试路由。

5. 查看具体报错定位问题 #

如果以上方案都没有解决问题，可以查看Apache错误日志获取具体的报错信息，日志默认路径为/var/log/apache2/error.log，根据日志中的报错栈可以精准定位问题原因。

内容的提问来源于stack exchange，提问作者Omid Soroush