JBoss 7.3→7.4.1与Java8→17迁移时JSP编译报错System无法解析

问题根源 #

Java 9+引入的模块化系统（JPMS）改变了类的默认可见性规则，JBoss 7.4.1搭载的JSP编译组件（基于升级后的Tomcat Jasper）在Java 17环境下，可能因默认导入配置缺失、模块访问权限限制，导致java.lang包下的类无法被JSP自动识别。

解决方案 #

1. 修正JBoss JSP容器默认导入配置 #

找到JBoss安装目录下的standalone/configuration/standalone.xml（集群环境用domain.xml），定位到web子系统配置块（标签通常为<subsystem xmlns="urn:jboss:domain:web:x.x"，x.x为版本号），添加或确保jsp-config中包含java.lang.*的默认导入：

<jsp-config>
    <default-imports>
        <package>java.lang.*</package>
        <package>java.util.*</package>
        <!-- 保留其他原有默认导入包 -->
    </default-imports>
</jsp-config>

修改后重启JBoss生效。

2. 添加JSP编译模块访问参数 #

在同一jsp-config块中添加编译参数，确保JSP编译时能访问包含java.lang的java.base核心模块：

<jsp-config>
    <!-- 保留原有default-imports配置 -->
    <compiler-options>
        <option value="-J--add-modules=java.base"/>
    </compiler-options>
</jsp-config>

3. 全局配置JSP导入（替代单个JSP导入） #

若单个JSP添加import指令无效，可在项目web.xml中配置全局JSP属性组，强制导入java.lang包：

<jsp-config>
    <jsp-property-group>
        <url-pattern>*.jsp</url-pattern>
        <import>java.lang.*</import>
    </jsp-property-group>
</jsp-config>

4. 清理JBoss编译缓存 #

JBoss会缓存已编译的JSP文件，旧缓存可能导致配置不生效：

• 停止JBoss服务
• 删除standalone/tmp/vfs和standalone/tmp/work目录下的所有文件
• 重启JBoss，触发JSP重新编译

5. 验证Eclipse项目配置 #

确认项目JSP编译相关设置与Java 17兼容：

• 右键项目 → 属性 → Java EE模块设置 → JSP，确保“编译器合规级别”设为17，且“默认导入”包含java.lang.*
• 检查项目根目录下的org.eclipse.wst.common.project.facet.core.xml，确保jst.web的版本与JBoss 7.4.1兼容（建议3.1及以上）

验证步骤 #

应用上述任一方案后重启JBoss，访问报错的JSP页面。若问题仍存在，查看standalone/log/server.log日志，排查是否有模块访问被拒绝等更详细的编译错误信息。

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