Tomcat 8.5.27使用类型推断时JSP编译报‘illegal start of type’错误

这种版本差异导致的JSP编译错误我碰过不少，核心原因就是Tomcat 8.x对JSP的编译逻辑做了严格化调整——相比7.x的宽松处理，它会在编译生成的Java文件中添加一些符合新规范的代码片段，而你的JSP代码里可能存在一些在7.x中被忽略的语法不严谨之处，到了8.x就触发了编译错误。

具体原因拆解 #

Tomcat 8.x默认使用JSP 2.3规范（对应Servlet 3.1），而7.x是JSP 2.2（Servlet 3.0），两者的编译逻辑主要差异点包括：

• 对JSP脚本片段（<% %>）中变量作用域的处理更严格：7.x可能会自动调整零散变量的作用域，但8.x会严格遵循Java语法，把未放在代码块中的变量声明提升为类成员变量，这很容易引发"illegal start of type"错误；
• 默认升级了Eclipse JDT编译器版本，对语法检查的容忍度更低；
• 对EL表达式、自定义标签的解析逻辑做了优化，一些在7.x中能正常解析的写法，在8.x中会被判定为语法错误。

针对性解决方案 #

1. 检查并修正JSP中的脚本代码 #

这是最常见的问题根源，重点排查：

• 把所有<% %>中的变量声明放在代码块（{}）内，比如原来的：

  <% int i = 0; %>
  <% i++; %>
  

  改成：

  <% {
      int i = 0;
      i++;
  } %>
  

  确保变量始终处于局部作用域，避免被Tomcat 8.x错误地提升为类成员变量。
• 避免在JSP声明块（<%! %>）中编写执行语句，声明块只能用来定义类的成员变量、方法或静态块，比如下面的写法在8.x中会报错：

  <%! System.out.println("test"); %> <!-- 错误：声明块不能直接写执行语句 -->
  

2. 调整Tomcat的JSP编译参数 #

如果不想修改JSP代码，可以尝试让Tomcat 8.x的编译器兼容7.x的行为：

• 打开Tomcat安装目录下的conf/web.xml，找到jsp-servlet配置节点，添加以下初始化参数：

  <servlet>
      <servlet-name>jsp</servlet-name>
      <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
      <!-- 添加兼容参数 -->
      <init-param>
          <param-name>compilerSourceVM</param-name>
          <param-value>1.7</param-value> <!-- 和Tomcat 7.x使用的Java版本一致 -->
      </init-param>
      <init-param>
          <param-name>compilerTargetVM</param-name>
          <param-value>1.7</param-value>
      </init-param>
      <init-param>
          <param-name>compiler</param-name>
          <param-value>javac</param-value> <!-- 切换到javac编译器，部分场景下兼容性更好 -->
      </init-param>
      <load-on-startup>3</load-on-startup>
  </servlet>
  

3. 降低JSP版本兼容性级别 #

在JSP页面的page指令中指定更低的JSP版本，让编译器按照7.x的规范处理：

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8" version="2.2" %> <!-- 指定为JSP 2.2，对应Tomcat 7.x的规范 -->

4. 定位编译后的Java文件精准排查 #

如果以上方法都没解决，可以直接查看Tomcat编译生成的Java文件：

• 编译后的文件默认存放在Tomcat的work/Catalina/localhost/你的项目名/org/apache/jsp目录下；
• 找到报错对应的.java文件，定位到"illegal start of type"的行，对比JSP代码就能精准找到问题所在。

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