Django无限流响应客户端断开时Apache日志报500错误如何解决

你当前的异常捕获逻辑只覆盖了视图返回响应对象的阶段，而StreamingHttpResponse的流内容迭代是在视图返回后、Django WSGI容器向Apache输出响应的阶段执行的，此时客户端主动断开连接会触发BrokenPipeError/ConnectionResetError，这个异常没有被你的视图内try块捕获，Django默认会将这类未捕获异常对应的请求标记为500状态码返回给Apache，才会产生你看到的日志记录。

以下是两种可行的解决方案：

方案1：Django层捕获流迭代异常（最稳妥） #

将你的流迭代器包裹一层异常捕获逻辑，遇到客户端断连相关异常时直接终止迭代，不向外抛出，这样Django会判定请求正常结束，不会生成500状态码。你可以根据需要指定最终返回的状态码，比如参考行业惯例用499标记客户端主动断连场景。
修改后的代码示例：

def my_view(request):
    def wrapped_stream():
        try:
            for x in data_stream(...):
                yield f"{dumps(x)}\n"
        except (BrokenPipeError, ConnectionResetError):
            # 客户端断连，直接终止迭代，不抛异常
            return
        except Exception as e:
            # 这里捕获data_stream本身的逻辑异常，打日志区分
            print_exc()
            yield dumps({
                "success": False,
                "reason": ERROR_WITH_CLASSNAME.format(e.__class__.__name__)
            })
    try:
        # 可以指定默认状态码为200，或者自定义499
        return StreamingHttpResponse(wrapped_stream())
    except Exception as e:
        # 这里捕获流构造阶段的异常
        print_exc()
        return HttpResponse(dumps({
            "success": False,
            "reason": ERROR_WITH_CLASSNAME.format(e.__class__.__name__)
        }), status=500, content_type="application/json")

方案2：Apache层修改日志规则 #

如果不想改业务代码，可以调整Apache的日志配置，将断连导致的500日志标记为其他状态码或者排除统计：

• 开启mod_log_config，自定义日志格式，匹配请求错误原因为Broken pipe的条目，将日志中的状态码替换为499
• 配置监控规则过滤掉对应请求路径下、错误原因为断连的500日志，避免误报

两种方案优先选第一种，业务逻辑内可以明确区分断连和业务异常，日志统计更清晰。

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