在使用 Connexion（v2.13.0）托管 Swagger UI 时，直接通过 after_request 打印响应体易导致 Swagger UI 资源加载失败；本文提供一种兼容性强、不破坏中间件链的替代方案——基于装饰器的按需日志记录。

在使用 connexion（v2.13.0）托管 swagger ui 时，直接通过 `after_request` 打印响应体易导致 swagger ui 资源加载失败；本文提供一种兼容性强、不破坏中间件链的替代方案——基于装饰器的按需日志记录。

当在 Connexion 应用中尝试通过 Flask 的 before_request / after_request 全局钩子统一打印请求与响应载荷时，常会遇到一个隐蔽但关键的问题：Swagger UI 的静态资源（如 /swagger.json、/ui/ 下的 HTML/JS/CSS）或重定向响应（如根路径跳转到 /ui/）会被 response.get_data() 提前消费——这将导致响应流被读取并关闭，后续 WSGI 层无法再次读取 body，最终使 Swagger UI 白屏或报 500 错误。

根本原因在于：response.get_data()（尤其是 as_text=False）会调用底层 response.response 迭代器并耗尽其内容，而 Connexion v2 的响应处理链依赖原始响应对象完成最终渲染与传输。一旦 body 被提前读取，response 将变为不可重复读状态，破坏了框架内部流程。

✅ 推荐解决方案：轻量级路由级日志装饰器
该方式规避全局钩子副作用，仅对明确需要调试的 API 路由生效，完全兼容 Swagger UI：

from functools import wraps
import json
import logging
from flask import request, g

logger = logging.getLogger(__name__)

def log_request_response(pretty_print=True):
    """装饰器：打印指定路由的请求与响应（仅 JSON 路由推荐）"""
    def decorator(f):
        @wraps(f)
        def decorated_function(*args, **kwargs):
            # 1. 记录请求
            method = request.method
            path = request.path
            logger.debug(f"[{method}] {path} — Request received")

            if method not in ('GET', 'HEAD') and request.is_json:
                try:
                    data = request.get_json()
                    body_str = json.dumps(data, separators=(',', ':')) if not pretty_print else json.dumps(data, indent=2)
                    logger.debug(f"→ Request Body: {body_str}")
                except Exception as e:
                    logger.debug(f"→ Request Body (raw): {request.get_data(as_text=True)[:200]}... [parse failed: {e}]")

            # 2. 执行原函数
            response = f(*args, **kwargs)

            # 3. 记录响应（安全方式：仅对 JSON 响应解析，避免读取非 JSON body）
            if hasattr(response, 'get_json') and callable(response.get_json):
                try:
                    json_data = response.get_json()
                    if json_data is not None:
                        body_str = json.dumps(json_data, separators=(',', ':')) if not pretty_print else json.dumps(json_data, indent=2)
                        logger.debug(f"← Response Body: {body_str}")
                except Exception as e:
                    logger.debug(f"← Response Body parse failed: {e}")

            return response
        return decorated_function
    return decorator

? 使用示例（在 Connexion 的 api.yml 对应的 Python 函数上添加）：

@log_request_response(pretty_print=False)  # 关闭缩进以节省日志空间
def create_user(body):
    return {'id': 123, 'name': body.get('name')}, 201

@log_request_response(pretty_print=True)
def get_users():
    return [{'id': 1, 'name': 'Alice'}], 200

⚠️ 注意事项：

• *不建议对 Swagger UI 路由（如 /, /swagger.json, `/ui/`）启用该装饰器** —— 它们返回的是字符串、HTML 或二进制资源，非 JSON，强行解析会出错且无意义；
• 若需监控所有请求（含非 JSON），可改用 flask.logging 或 WSGI 中间件（如自定义 ProxyMiddleware），但复杂度显著上升；
• request.get_data() 在装饰器中调用是安全的，因其发生在视图函数执行前，且不会干扰后续响应生成；
• Connexion v2.13.0 + Flask 2.2.5 组合下，此方案已验证可稳定运行，不影响 Swagger UI 加载与交互。

? 总结：在受限于旧版 Connexion 的项目中，放弃“一刀切”的全局钩子，转而采用精准可控的装饰器模式，是兼顾可观测性与稳定性的务实选择。它既满足调试需求，又彻底规避了因响应体提前读取引发的 UI 崩溃问题。