Django应用部署到cPanel后无法通过后台上传图片的解决方法

以下是针对该问题的具体排查和解决步骤：

1. 检查媒体目录权限 #

cPanel环境下，Django的媒体文件目录（即MEDIA_ROOT指向的目录）需要具备正确的权限，确保web服务器进程能写入文件：

• 目录权限设置为755，文件权限设置为644
• 通过cPanel文件管理器右键目标目录，选择“更改权限”进行调整；或通过终端执行命令：

  chmod -R 755 /home/your_cpanel_username/public_html/media
  chown -R your_cpanel_username:nobody /home/your_cpanel_username/public_html/media
  

  注：部分主机的web服务器用户组可能是apache而非nobody，需根据主机配置调整

2. 确认Django媒体配置正确性 #

检查项目settings.py中的媒体相关配置，确保路径和URL设置准确：

import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 媒体文件配置
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')  # 或使用绝对路径：'/home/your_username/public_html/media'
MEDIA_URL = '/media/'

注意：如果使用Passenger部署，必须使用绝对路径定义MEDIA_ROOT，避免路径解析错误

3. 配置Passenger处理媒体请求（Passenger部署场景） #

若通过cPanel的Passenger模块部署Django，需在passenger_wsgi.py中添加媒体文件的路由处理，确保web服务器能正确返回媒体文件：

from django.core.wsgi import get_wsgi_application
from django.conf import settings
from django.views.static import serve
import os
import sys

# 添加项目路径到系统路径
sys.path.insert(0, os.path.dirname(__file__))
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project_name.settings')

# 初始化Django应用
application = get_wsgi_application()

# 包装应用以处理媒体文件请求
def media_aware_application(environ, start_response):
    path = environ.get('PATH_INFO', '')
    if path.startswith(settings.MEDIA_URL):
        return serve(environ, path, document_root=settings.MEDIA_ROOT)
    return application(environ, start_response)

application = media_aware_application

4. 调整cPanel文件上传限制 #

cPanel默认的PHP上传限制可能过小，导致大尺寸图片上传失败：

1. 进入cPanel的“选择PHP版本”工具
2. 切换到“选项”标签页
3. 调整upload_max_filesize和post_max_size的值（例如设置为20M）
4. 保存更改后重启PHP服务

5. 查看错误日志定位问题 #

若以上步骤无效，需通过日志排查具体错误：

• 在settings.py中添加日志配置，记录Django的调试信息：

  LOGGING = {
      'version': 1,
      'disable_existing_loggers': False,
      'handlers': {
          'file': {
              'level': 'DEBUG',
              'class': 'logging.FileHandler',
              'filename': '/home/your_username/django_upload_errors.log',
          },
      },
      'loggers': {
          'django.core.files.uploadhandler': {
              'handlers': ['file'],
              'level': 'DEBUG',
              'propagate': True,
          },
      },
  }
  

• 或直接查看cPanel的“错误日志”工具，获取web服务器返回的具体错误信息（如权限拒绝、路径不存在等）

内容的提问来源于stack exchange，提问作者Mohammad Hawa