如何调试基于Apache Cocoon的Java 1.7 Web应用空指针异常

1. 先从错误栈锁定关键环节 #

浏览器抛出的栈信息显示，空指针（NPE）直接触发在context:/model-runs/sitemap.xmap第284行的<map:serialize type="html">，往上追溯是i18n转换、两次XSLT转换，源头是serverpages生成步骤。调试重点就围绕这些Cocoon组件的执行逻辑展开。

2. 具体断点设置位置 #

（1）Cocoon核心组件类 #

• ServerPages生成器：直接定位org.apache.cocoon.generation.ServerPagesGenerator类，在它的generate()方法打断点。先确认该组件输出的XML内容是否存在空节点或缺失必要数据。
• XSLT转换器：找到org.apache.cocoon.transformation.TraxTransformer，在transform()方法设断点。重点检查两次XSLT转换（对应sitemap第272、273行）后的XML文档状态，排查哪一步出现了null值。
• i18n转换器：定位org.apache.cocoon.transformation.I18nTransformer的transform()方法，检查国际化处理时是否缺少资源键，或本地化上下文为null。
• HTML序列化器：直接盯org.apache.cocoon.serialization.HTMLSerializer的serialize()方法——这是NPE发生的直接位置，重点查看传入的SAX事件源、序列化配置是否为null，比如输出流是否未初始化。

（2）自定义业务代码 #

如果项目有自定义生成器、转换器（比如自定义XSLT扩展函数、定制serverpage逻辑），直接在这些自定义类的核心方法打断点：

• 若存在自定义XSLT扩展，检查扩展函数的返回值是否可能为null；
• 自定义ServerPages相关Java代码中，确认数据模型是否正确初始化，有没有返回null的场景。

3. 调试执行步骤 #

• 启动Tomcat调试模式，要么用Eclipse内置Tomcat直接跑调试，要么连接远程调试（部署在外部Tomcat时）；
• 触发出错的动态页面请求，断点命中后逐步调试：
  1. 先查看ServerPagesGenerator生成的XML结构是否完整，有无空元素、空属性；
  2. 每完成一次转换，检查XML文档的变化，确认哪一步开始出现null；
  3. 到HTMLSerializer环节时，仔细检查序列化器的上下文对象、输出流是否为null，传入的SAX事件参数是否有空值。

4. 快速缩小范围的小技巧 #

• 临时修改sitemap.xmap，先注释掉i18n转换步骤，看是否还报错，快速定位是否为国际化组件的问题；
• 检查项目的i18n资源文件（.properties）是否存在，对应资源键是否完整，资源找不到常返回null触发NPE；
• 查看Tomcat日志目录下的完整异常栈，浏览器显示的是简化版，完整栈会告诉你具体是哪个类的哪一行抛出的NPE，定位更精准。

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