为什么JSP代码不能在浏览器直接运行？

一、直接打开 JSP 文件会看到什么现象？

很多刚接触 Java Web 开发的读者会习惯性地在本地文件系统双击 index.jsp，或者在编辑器中右键选择“在默认浏览器中打开”。此时浏览器地址栏通常显示的是以 file:/// 开头的本地路径，而渲染出来的页面往往是一团混乱的原始代码，或者直接弹出一个文件下载提示窗口。

假设我们编写了如下一段最基础的 demo.jsp 测试文件：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>时间问候</title>
</head>
<body>
    <h1>欢迎访问网站</h1>
    <%
        java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String currentTime = sdf.format(new java.util.Date());
    %>
    <p>当前服务器时间是：<%= currentTime %></p>
</body>
</html>

当通过 file:/// 协议直接在浏览器中打开该文件时，浏览器无法识别 <% ... %> 是什么标记。由于它不知道如何执行 Java 代码，遇到未知的标签时，大部分浏览器会直接将这些文本暴露在页面上，或者因为未知的 MIME 类型而将其视作二进制文件直接下载。代码中本该由 Java 计算输出的时间变量 <%= currentTime %> 根本不会被计算，而是原封不动地显示为字符字面量。

图 1：本地文件读取与 Web 容器网络处理在浏览器端呈现的根本差异

二、为什么浏览器读不懂 JSP？

要理解这个问题，首先需要分清客户端软件（浏览器）与服务端软件（Web 容器）各自拥有的运行能力和技术边界。

1. 浏览器的“语言能力”极其固定

现代浏览器本质上是一个图形界面渲染程序，它的内核主要由两部分构成：

• 渲染排版引擎（如 Blink、WebKit、Gecko）：负责解析 HTML 标记构建 DOM 树，解析 CSS 规则生成渲染树，并将界面像素绘制到屏幕上。
• JavaScript 引擎（如 V8、JavaScriptCore）：负责编译并执行 JavaScript 脚本代码，处理前端交互与网络异步通信。

浏览器无法执行 Java 语言代码。Java 语法的运行必须依赖 Java 虚拟机（JVM），需要类加载器、字节码执行器和垃圾回收器等一整套庞大的运行时系统。浏览器内部既没有 JVM，也没有 Java 核心类库（如 java.util.*、java.text.*），更不存在 JSP 规范中所依赖的 HttpServletRequest、HttpServletResponse 等对象。

2. JSP 标签在浏览器眼里的本质

HTML 语法具有固定的容错解析规则。当浏览器遇到 <%、<%@、<%= 等字符组合时，它们并不符合 W3C 的标准 HTML 标签定义。对于无法识别的标签内容，浏览器最合理的做法就是当成纯粹的文本字符流直接打印出来，或者因标签嵌套语法错乱而将其全部忽略。这就是为什么浏览器绝不可能凭自身直接“运行”JSP。

图 2：客户端浏览器与服务端 Web 容器的架构能力与数据流动对比

三、深入本质：JSP 在服务器里经历了什么？

很多开发者将 JSP 视作“写着 Java 代码的 HTML 网页”，但从底层原理来看，这种认知是颠倒的。JSP 的本质其实是一个 Java Servlet 类。我们在 JSP 中书写的所有普通 HTML 标签，在经过服务器翻译后，都会被转换成 Java 输出语句。

1. JSP 的生命周期与处理阶段

当客户端向支持 JSP 的服务器（例如 Apache Tomcat）发起第一次访问请求时，Web 容器内部会经历以下严密的推导与执行周期：

1. 接收请求：客户端通过 HTTP 协议发送 GET /demo.jsp，Tomcat 的 JspServlet 捕获该请求。
2. 代码翻译（Translation）：Tomcat 内置的 JSP 编译器（Jasper）读取 demo.jsp 文件，将其翻译为一个标准的 Java 类源文件（通常命名为 demo_jsp.java，继承自 HttpJspBase）。
3. 代码编译（Compilation）：调用 JDK 的 javac 工具，将生成的 demo_jsp.java 编译为字节码文件 demo_jsp.class。
4. 类加载与实例化：JVM 将该 class 文件加载至内存中并创建其实例，执行 jspInit() 进行初始化。
5. 服务调用（Execution）：容器调用其核心的 _jspService(request, response) 方法，执行开发者编写的业务逻辑。
6. 渲染并输出 HTML：在 _jspService 方法内部，所有的静态 HTML 代码与动态 Java 输出语句都被统一写入 JspWriter（即 out 流），最终经由 TCP 连接发送回浏览器。

图 3：JSP 从原始模板到被浏览器作为纯 HTML 接收的四步推导流

2. 翻译后的 Java 代码长什么样？

为了直观印证上述过程，我们可以查看 Tomcat 工作目录（通常位于 work/Catalina/localhost/ROOT/org/apache/jsp/）下生成的 demo_jsp.java 文件片断：

public final class demo_jsp extends org.apache.jasper.runtime.HttpJspBase
    implements org.apache.jasper.runtime.JspSourceDependent {

    public void _jspService(final HttpServletRequest request, final HttpServletResponse response)
        throws IOException, ServletException {

        final JspWriter out = response.getWriter();

        // 静态 HTML 被翻译为 out.write 输出
        out.write("<html>\r\n<head>\r\n    <title>时间问候</title>\r\n</head>\r\n<body>\r\n");
        out.write("    <h1>欢迎访问网站</h1>\r\n");

        // 开发者写的 Java 片段被原封不动嵌入方法中执行
        java.text.SimpleDateFormat sdf = new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String currentTime = sdf.format(new java.util.Date());

        out.write("    <p>当前服务器时间是：");
        // 表达式 <%= currentTime %> 被转化为 out.print
        out.print(currentTime);
        out.write("</p>\r\n</body>\r\n</html>");
    }
}

通过这段代码可以一目了然：浏览器最终拿到并渲染的，根本就不是 JSP 文件本身，而是 out.write() 打印出来的 HTML 纯文本字符。脱离了 Tomcat 容器的翻译和执行，这些 Java 逻辑就无处安放。

四、如何正确运行并查看 JSP 页面？

既然 JSP 不能在本地直接双击打开，那么要让其正常显示，就需要搭建一个标准的服务端运行环境。以下是运行一个 JSP 文件的标准实操步骤：

步骤 1：安装必要的基础运行环境

运行 JSP 必须具备两个核心组件：

• JDK（Java Development Kit）：提供 Java 运行环境（JVM）及编译器（javac）。
• Servlet 容器：例如 Apache Tomcat、Jetty、GlassFish 等。初学者推荐使用目前依然最广泛的 Apache Tomcat。

步骤 2：将 JSP 部署到 Web 容器的应用目录

将编写好的 demo.jsp 文件放置在 Tomcat 安装目录下的 webapps 目录中。例如放置在 webapps/ROOT/demo.jsp（ROOT 为默认根路径应用），或者自建目录如 webapps/myweb/demo.jsp。

步骤 3：启动 Web 容器服务

进入 Tomcat 的 bin 目录下，启动服务：

• Windows 系统：双击运行 startup.bat。
• Linux / macOS 系统：在终端中执行 ./catalina.sh run 或 ./startup.sh。

看到终端输出 Server startup in [xxx] milliseconds 即代表服务器已正常监听对应端口（默认为 8080）。

步骤 4：通过 HTTP 协议在浏览器发起访问

打开浏览器，在地址栏中输入标准的 HTTP 网络 URL：

http://localhost:8080/demo.jsp
或
http://localhost:8080/myweb/demo.jsp

此时，请求由网络层到达 Tomcat，Tomcat 自动完成翻译与编译，浏览器即可收到正确的计算时间并完成正常渲染。

五、知识总结与现代 Web 发展视角

理解了 JSP 无法直接运行的机制，就能建立起清晰的前后端边界思维。下表梳理了 JSP 与普通前端文件的本质区别：

图 4：JSP 技术特征总结与现代前后端分离演变概览