org.xml.sax.SAXException:错误处理 [jar:file:{app}/WEB-INF/lib/jsf-impl-2.2.9.jar!/META-INF/mojarra_ext.taglib.xml@47,31]

org.xml.sax.SAXException: Error Handling [jar:file:{app}/WEB-INF/lib/jsf-impl-2.2.9.jar!/META-INF/mojarra_ext.taglib.xml@47,31]

我们的 JSF 应用程序在部署到 tomcat 时工作正常,但是,当我们访问 UI 中的第一个页面时出现此错误。之后其他页面就没有看到这个错误了。

这些是我们正在使用的 jsf 依赖项:

<dependency>
            <groupId>com.sun.faces</groupId>
            <artifactId>jsf-api</artifactId>
            <version>2.2.9</version>
            <type>jar</type>
        </dependency>
        <dependency>
            <groupId>com.sun.faces</groupId>
            <artifactId>jsf-impl</artifactId>
            <version>2.2.9</version>
            <type>jar</type>
        </dependency>

这是错误堆栈跟踪:

SEVERE: Error Loading Library: jar:file:../.metadata/.plugins/org.eclipse.wst.server.core/tmp1/wtpwebapps/{app}/WEB-INF/lib/jsf-impl-2.2.9.jar!/META-INF/mojarra_ext.taglib.xml
java.io.IOException: Error parsing [jar:file:../.metadata/.plugins/org.eclipse.wst.server.core/tmp1/wtpwebapps/{app}/WEB-INF/lib/jsf-impl-2.2.9.jar!/META-INF/mojarra_ext.taglib.xml]: 
    at com.sun.facelets.compiler.TagLibraryConfig.create(TagLibraryConfig.java:410)
    at com.sun.facelets.compiler.TagLibraryConfig.loadImplicit(TagLibraryConfig.java:431)
    at com.sun.facelets.compiler.Compiler.initialize(Compiler.java:87)
    at com.sun.facelets.compiler.Compiler.compile(Compiler.java:104)
    at com.sun.facelets.impl.DefaultFaceletFactory.createFacelet(DefaultFaceletFactory.java:197)
    at com.sun.facelets.impl.DefaultFaceletFactory.getFacelet(DefaultFaceletFactory.java:144)
    at com.sun.facelets.impl.DefaultFaceletFactory.getFacelet(DefaultFaceletFactory.java:95)
    at com.sun.facelets.FaceletViewHandler.buildView(FaceletViewHandler.java:517)
    at com.sun.facelets.FaceletViewHandler.renderView(FaceletViewHandler.java:567)
    at com.sun.faces.lifecycle.RenderResponsePhase.execute(Unknown Source)
    at com.sun.faces.lifecycle.Phase.doPhase(Unknown Source)
    at com.sun.faces.lifecycle.LifecycleImpl.render(Unknown Source)
    at javax.faces.webapp.FacesServlet.service(Unknown Source)
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:305)
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:210)
    at com.bphx.cool.jsf.CustomHeaderFilter.doFilter(CustomHeaderFilter.java:51)
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:243)
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:210)
    at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:222)
    at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:123)
    at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:611)
    at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:171)
    at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:99)
    at org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:953)
    at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:118)
    at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:408)
    at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1023)
    at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:589)
    at org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:312)
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
    at java.lang.Thread.run(Thread.java:744)
Caused by: org.xml.sax.SAXException: Error Handling [jar:file:../.metadata/.plugins/org.eclipse.wst.server.core/tmp1/wtpwebapps/{app}/WEB-INF/lib/jsf-impl-2.2.9.jar!/META-INF/mojarra_ext.taglib.xml@47,31]
    at com.sun.facelets.compiler.TagLibraryConfig$LibraryHandler.error(TagLibraryConfig.java:376)
    at com.sun.org.apache.xerces.internal.util.ErrorHandlerWrapper.error(ErrorHandlerWrapper.java:137)
    at com.sun.org.apache.xerces.internal.impl.XMLErrorReporter.reportError(XMLErrorReporter.java:437)
    at com.sun.org.apache.xerces.internal.impl.XMLErrorReporter.reportError(XMLErrorReporter.java:368)
    at com.sun.org.apache.xerces.internal.impl.XMLErrorReporter.reportError(XMLErrorReporter.java:325)
    at com.sun.org.apache.xerces.internal.impl.dtd.XMLDTDValidator.rootElementSpecified(XMLDTDValidator.java:1599)
    at com.sun.org.apache.xerces.internal.impl.dtd.XMLDTDValidator.handleStartElement(XMLDTDValidator.java:1877)
    at com.sun.org.apache.xerces.internal.impl.dtd.XMLDTDValidator.startElement(XMLDTDValidator.java:742)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanStartElement(XMLDocumentFragmentScannerImpl.java:1370)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl$ContentDriver.scanRootElementHook(XMLDocumentScannerImpl.java:1290)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl$FragmentContentDriver.next(XMLDocumentFragmentScannerImpl.java:3130)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl$PrologDriver.next(XMLDocumentScannerImpl.java:880)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl.next(XMLDocumentScannerImpl.java:606)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanDocument(XMLDocumentFragmentScannerImpl.java:510)
    at com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(XML11Configuration.java:848)
    at com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(XML11Configuration.java:777)
    at com.sun.org.apache.xerces.internal.parsers.XMLParser.parse(XMLParser.java:141)
    at com.sun.org.apache.xerces.internal.parsers.AbstractSAXParser.parse(AbstractSAXParser.java:1213)
    at com.sun.org.apache.xerces.internal.jaxp.SAXParserImpl$JAXPSAXParser.parse(SAXParserImpl.java:649)
    at com.sun.org.apache.xerces.internal.jaxp.SAXParserImpl.parse(SAXParserImpl.java:333)
    at javax.xml.parsers.SAXParser.parse(SAXParser.java:195)
    at com.sun.facelets.compiler.TagLibraryConfig.create(TagLibraryConfig.java:407)
    ... 31 more

我能做些什么来防止这个错误日志?

Caused by: org.xml.sax.SAXException: Error Handling [jar:file:../.metadata/.plugins/org.eclipse.wst.server.core/tmp1/wtpwebapps/{app}/WEB-INF/lib/jsf-impl-2.2.9.jar!/META-INF/mojarra_ext.taglib.xml@47,31]

错误出现在 jsf-impl-2.2.9.jar 文件中的 /META-INF/mojarra_ext.taglib.xml 文件的第 47 行,第 31 个字符。如果您使用 ZIP 工具打开 JAR 并在第 47 行附近浏览该 taglib 文件,那么您将看到:

44    <facelet-taglib xmlns="http://xmlns.jcp.org/xml/ns/javaee"
45                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
46                    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibrary_2_2.xsd"
47                    version="2.2">
48        <namespace>http://mojarra.dev.java.net/mojarra_ext</namespace>
49        <tag>

这是 version="2.2" 所在的行。这表明存在版本冲突。首先,您需要确保您的 Web 应用程序的 /WEB-INF/faces-config.xml 文件已根据 JSF 2.2 正确声明,而不是更早的版本:

<?xml version="1.0" encoding="UTF-8"?>
<faces-config
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd"
    version="2.2">
    <!-- Config here -->
</faces-config>

并且您还需要确保 webapp 的 /WEB-INF/lib 不包含任何 Facelets 1.x JAR 文件。堆栈跟踪中的包 com.sun.facelets.* 表明在运行时类路径中存在 Facelets 1.x,这在使用 JSF 2.x 时是不正确的,因为它已经与 Facelets 2.x 捆绑在一起,这是在包 com.sun.faces.facelets.*.

恕我直言,我认为所选择的答案并不能真正解决这个问题。至少它没有为我解决。

引发此异常 (com.sun.facelets.compiler.TagLibraryConfig$LibraryHandler) 的 class 来自独立的 Facelet 实现。如果调试此问题,您会发现此错误的根本原因是 XML 的根元素与 DTD 不匹配(提示:XMLDTDValidator.rootElementSpecified)。

鉴于 TagLibraryConfig 仅存在于独立的 Facelets 中,您可能遇到了与我相同的问题。发生的事情是,当旧的 Facelet 的 TagLibraryConfig 扫描 classpath 以查找 META-INF/**/*.taglib.xml 下的所有 facelet 标签库时,它会选择 Mojarra 的 META-INF/mojarra_ext.taglib.xml,它与旧的 DTD 不完全兼容(例如版本属性没有'当时存在)。它记录失败并愉快地继续。

避免此错误的最佳方法是开始使用 JSF 中内置的 Facelets 2.x。

但是,如果您坚持使用 Facelets 1.x(例如,因为您正在使用 RichFaces 3.x)并且对忽略此异常的含义感到好奇,您应该知道所有的标签库是它提供了三个特定于 Mojarra 的标签:

  • regexValidator 重复 f:validateRegex 自 JSF 2.0
  • 可用
  • creditcardValidator 执行基本的信用卡号格式验证和 Luhn 检查
  • focus 呈现一个小脚本,将焦点设置在任意元素上。

如果您不需要这些标签,忽略此错误是非常安全的。我考虑了几种将其从日志中删除的方法,但每种解决方案(关闭记录器、自定义上下文 classloader 或自定义 FaceletViewHandler)要么有缺点,要么对于这样一个不重要的问题似乎有点矫枉过正。