Spring MVC调用JSP页面出现org.apache.tiles.util.TilesIOException报错如何解决

• 第一步：核对JSP路径配置
  • 检查tiles.xml中定义的JSP路径与项目实际文件路径是否完全匹配，注意Linux环境下路径大小写敏感，大小写不一致会直接触发该异常
  • 确认Spring MVC视图解析器的前缀、后缀配置与tiles配置规则不冲突，避免出现路径重复拼接后缀的问题，例如不要同时在tiles定义和视图解析器中配置.jsp后缀
• 第二步：排查JSP自身语法问题
  • 跳过tiles路由，直接通过浏览器访问对应JSP页面，检查是否存在未闭合标签、未引入标签库、EL表达式语法错误等问题，JSP自身的编译异常会被tiles包装为该IO异常
  • 核对JSP中<include>引入的其他JSP片段、静态资源路径是否正确，子资源路径错误也会触发该异常
• 第三步：校验Tiles依赖与基础配置
  • 确认tiles依赖版本与Spring MVC版本兼容，Spring 5.x 推荐搭配 Tiles 3.0.x 版本，版本不兼容导致的类加载异常会间接触发该IO异常
  • 检查web.xml中Tiles监听器、配置文件路径配置是否正确，参考配置如下：

    <listener>
        <listener-class>org.apache.tiles.extras.complete.CompleteAutoloadTilesListener</listener-class>
    </listener>
    <context-param>
        <param-name>org.apache.tiles.definition.DefinitionsFactory.DEFINITIONS_CONFIG</param-name>
        <param-value>/WEB-INF/tiles.xml</param-value>
    </context-param>
    

• 第四步：查看完整异常栈定位根因
  • 开启debug级别日志，提取异常栈完整的Caused by节点信息，该异常通常为包装异常，底层根因（文件不存在、类未找到、JSP编译失败等）都会在嵌套异常中明确标注

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