Django生产环境中FileResponse异常问题求助

本地环境中使用Django的FileResponse功能一切正常，但部署到基于OpenLiteSpeed的生产环境时出现问题。

本地实现代码如下：

@login_required
@permission_required('plataforma.ADMIN', raise_exception=True)
def admin_descargar_planilla(request,plantilla_id):
    try:
        plantilla = Plantilla.objects.get(pk=plantilla_id)
    except:
        return render(request, "plataforma/error.html",{"tipo_error":"No se puede realizar esta accion ya que la plantilla ya no existe"})
    buffer = util.crear_pdf(plantilla)
    return FileResponse(buffer, content_type='application/pdf', filename=(plantilla.eett.username+" ("+str(plantilla.fecha)+")"))

其中crear_pdf函数返回io.BytesIO对象。在生产环境调用该视图时，服务器返回500内部服务器错误而非Django自身错误。此外，尝试使用已存在的PDF文件替代buffer，会出现404错误（提示URL不存在，但实际路径有效），该操作在本地环境正常。

排查方向与解决方案 #

针对500错误（BytesIO缓冲返回场景） #

• 查OpenLiteSpeed服务器日志：直接看服务器错误日志（通常在/usr/local/lsws/logs/error.log或站点专属日志目录），Django的异常可能被服务器拦截，日志里会有具体报错信息，比如PDF生成依赖库缺失、权限不足、资源耗尽等。
• 重置BytesIO指针位置：生成PDF后，BytesIO的指针会停在文件末尾，返回FileResponse前必须把指针移到开头，添加一行代码：

  buffer = util.crear_pdf(plantilla)
  buffer.seek(0)  # 新增该行，将指针重置到文件起始位置
  return FileResponse(buffer, content_type='application/pdf', filename=...)
  

• 检查Django生产日志配置：确保Django的日志系统正确输出到文件，这样能看到完整的异常栈，而不是只收到OpenLiteSpeed的500提示。
• 验证权限与资源限制：OpenLiteSpeed运行用户（通常是nobody或站点专属用户）是否有PDF生成相关操作的权限，比如临时文件读写、依赖库调用权限；同时检查服务器是否有内存、CPU配额限制，导致PDF生成过程中断。

针对404错误（直接返回本地文件场景） #

• 使用绝对路径定位文件：生产环境中相对路径可能失效，建议用Django配置的BASE_DIR或MEDIA_ROOT拼接绝对路径：

  from django.conf import settings
  import os
  file_path = os.path.join(settings.BASE_DIR, 'your/path/to/file.pdf')
  

• 配置OpenLiteSpeed文件映射：如果文件在MEDIA_ROOT或自定义目录下，需要在OpenLiteSpeed虚拟主机配置中，将请求路径映射到实际文件目录，否则服务器无法识别对应的URL路径。
• 修正文件权限：确保OpenLiteSpeed运行用户有读取该PDF文件的权限，执行如下命令（根据实际运行用户调整）：

  chmod 644 /path/to/your/file.pdf
  chown nobody:nobody /path/to/your/file.pdf
  

内容的提问来源于stack exchange，提问作者Snorlax Russo