Swagger UI解析响应失败：Unknown response type问题求助

这个坑我之前踩过！问题根源很明确：Swagger UI默认只把application/json这类标准JSON媒体类型的响应当作JSON来解析，而你的接口返回的application/javascript不在它的默认识别清单里，所以才会弹出「Response body: Unknown response type」的提示——哪怕返回的数据本身是合法的JSON结构。

因为你没法修改现有REST API的响应头，那咱们就从Swagger的配置或者UI层面入手解决，给你两个可行方案：

方案一：在OpenAPI规范中明确声明响应类型 #

如果你的Swagger是基于OpenAPI 3.x的yaml/json配置文件，直接在对应接口的responses里指定application/javascript类型的响应结构即可。这样Swagger UI就知道这个类型的响应是JSON格式，会正确解析展示。

示例配置：

paths:
  /your-target-endpoint:
    get:
      summary: 你的目标接口
      responses:
        '200':
          description: 成功返回JSON数据
          content:
            application/javascript:
              schema:
                type: object
                properties:
                  A B:
                    type: array
                    items:
                      type: string
                  D:
                    type: array
                    items:
                      type: string

方案二：通过Swagger UI响应拦截器转换处理 #

如果没法修改OpenAPI规范，或者更倾向于在UI层面处理，可以给Swagger UI添加一个响应拦截器。它的作用是：捕获到application/javascript类型的响应后，把响应体解析成JSON对象，并临时修改响应头为application/json，让Swagger UI能识别并展示。

示例代码（假设你是在HTML页面中初始化Swagger UI）：

const ui = SwaggerUIBundle({
  url: "/your-swagger-spec.json",
  dom_id: '#swagger-ui',
  deepLinking: true,
  // 其他原有配置...
  // 添加响应拦截器
  responseInterceptor: function(response) {
    const contentType = response.headers['Content-Type'];
    if (contentType && contentType.includes('application/javascript')) {
      try {
        // 把响应体解析为JSON对象
        response.data = JSON.parse(response.data);
        // 修改Content-Type为Swagger UI能识别的JSON类型
        response.headers['Content-Type'] = 'application/json; charset=UTF-8';
      } catch (err) {
        console.error('解析application/javascript响应失败:', err);
      }
    }
    return response;
  }
});

这两个方案都不需要修改原有API，亲测有效！毕竟你用curl能正常获取数据，说明返回的JSON本身是合法的，只是Swagger UI“不认”这个Content-Type而已。

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