SpringBoot自定义taglib引用时报Invalid tld file错误如何解决

错误原因 #

JSP规范对TLD文件的存放路径有强制约束：/WEB-INF/tags/是专门用于存放.tag/.tagx格式标签文件的预留目录，该目录下仅允许存在自动生成的implicit.tld文件，开发者自定义的.tld文件不允许存放在该路径下，也不允许在taglib引用的uri中直接指向该目录下的非implicit.tld文件，你看到的Tomcat源码拦截逻辑就是对该规范的实现。

解决方案 #

按以下步骤调整配置即可：

• 第一步：调整TLD文件存放位置
  将resourceBundle.tld从/WEB-INF/tags/目录移出，推荐放到新建的/WEB-INF/tld/目录或者/WEB-INF/根目录下，这两个都是规范允许的自定义TLD存放路径。
• 第二步：修改TLD文件内的uri配置
  将uri字段改为自定义的唯一逻辑标识，不需要和物理路径绑定，示例：

<taglib>
    <uri>custom:taglib:resourceBundle</uri>
    <!-- 其余TLD配置保持不变 -->
</taglib>

• 第三步：修改JSP中的taglib引用
  将uri改为你上面配置的逻辑标识即可：

<%@taglib prefix="ttl" uri="custom:taglib:resourceBundle" %>

SpringBoot额外注意事项 #

如果是采用内嵌Tomcat运行的SpringBoot项目，需要额外确认两点：

1. 已正确引入JSP相关依赖：tomcat-embed-jasper、jstl
2. Maven的pom.xml中已配置资源打包规则，确保WEB-INF目录下的所有文件会被正确打包到最终产物中。

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