如何通过JSP生成JSON而非HTML？

核心解决步骤 #

• 设置响应Content-Type与字符编码
  在JSP最顶部添加代码，明确告知客户端响应内容为JSON格式：

  <%@ page contentType="application/json;charset=UTF-8" pageEncoding="UTF-8" %>
  <%
    // 清空响应缓冲区，清除可能已输出的HTML内容
    response.reset();
    response.setContentType("application/json;charset=UTF-8");
    response.setCharacterEncoding("UTF-8");
  %>
  

• 移除所有HTML相关内容
  确保JSP文件中无任何HTML标签（如<html>、<body>）、多余空格或换行（尤其是JSP指令前后的空白），仅保留JSON生成逻辑。示例：

  <%@ page contentType="application/json;charset=UTF-8" pageEncoding="UTF-8" %>
  <%
    response.reset();
    response.setContentType("application/json;charset=UTF-8");
    // 示例JSON生成逻辑
    String jsonResult = "{\"code\":200,\"data\":\"success\"}";
    out.print(jsonResult);
    // 强制输出并关闭流，避免后续多余内容
    out.flush();
    out.close();
  %>
  

• 规避JSF组件干扰
  针对JSF环境，注意以下两点：

  • 不要使用<h:head>、<h:body>等JSF UI组件，这类组件会自动生成HTML结构
  • 可在JSF Bean中直接通过上下文输出响应，跳过视图渲染：

    FacesContext facesCtx = FacesContext.getCurrentInstance();
    ExternalContext extCtx = facesCtx.getExternalContext();
    extCtx.setResponseContentType("application/json");
    extCtx.setResponseCharacterEncoding("UTF-8");
    
    Writer responseWriter = extCtx.getResponseOutputWriter();
    responseWriter.write("{\"status\":\"ok\"}");
    responseWriter.flush();
    responseWriter.close();
    
    // 通知JSF终止后续视图处理
    facesCtx.responseComplete();
    

额外注意事项 #

• 检查JSP文件首尾，避免%>结束标记后残留换行或空白，这类字符会被输出为无效内容破坏JSON格式
• 排查JBoss4全局过滤器/拦截器，确认没有自动向响应中添加HTML相关内容

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