部署Eclipse EAR项目至JBoss EAP 6.1遇空指针错误求助

我之前也碰到过类似的糟心情况——用Eclipse部署包含Web项目和普通Java项目的EAR到JBoss EAP 6.1时，突然弹出空指针错误却没有任何有用的堆栈信息。下面是几个我亲测有效的排查和解决步骤：

1. 彻底清理缓存与发布文件 #

缓存堆积往往是这类莫名其妙错误的元凶：

• 在Eclipse中，点击顶部菜单 Project > Clean，选择所有项目，勾选「Start a build immediately」后执行清理。
• 关闭JBoss服务器，找到JBoss安装目录下的 standalone/deployments 文件夹，删除里面所有文件和子文件夹（包括那些带.deployed/.failed后缀的标记文件）。
• 回到Eclipse的Server视图，右键点击你的JBoss服务器，选择「Clean...」，完成后重启Eclipse和JBoss服务器。

2. 检查EAR部署描述符（application.xml） #

空指针很可能是因为部署描述符配置有误，导致Eclipse解析时出错：

• 打开EAR项目中的 META-INF/application.xml，仔细核对每个模块的配置：
  • Web项目的<web-uri>必须和Web项目导出的WAR文件名完全一致，<context-root>配置合法无特殊字符。
  • 普通Java项目的<module>标签要正确引用项目名称，没有拼写错误或遗漏。
• 确保描述符的XML语法完全正确，没有未闭合的标签或格式错误。

3. 校验项目依赖与部署组装配置 #

依赖关系混乱也会触发发布时的空指针：

• 打开EAR项目的属性窗口（右键项目 > Properties），进入「Deployment Assembly」页面，确认Web项目和普通Java项目都已正确添加，没有重复或无效的条目。
• 检查每个子项目的「Build Path」，确保没有引用不存在的JAR包或已删除的项目；Web项目要正确依赖普通Java项目，且依赖范围设置合理。
• 所有子项目和EAR项目都要关联正确的JBoss Runtime：进入项目属性的「Targeted Runtimes」，勾选「Red Hat JBoss EAP 6.1」。

4. 手动构建EAR并测试部署 #

如果上述步骤无效，可以排除Eclipse发布机制的问题：

• 在Eclipse中右键EAR项目，选择 Export > EAR file，导出一个完整的EAR包到本地目录。
• 手动将这个EAR包复制到JBoss的 standalone/deployments 文件夹，启动JBoss查看是否能正常部署。
  • 如果手动部署成功，说明问题出在Eclipse的服务器配置上：删除Server视图中的现有JBoss服务器，重新创建一个JBoss EAP 6.1服务器，再添加EAR项目进行发布。

5. 开启详细日志获取更多错误信息 #

如果还是无法解决，我们需要获取更详细的错误日志：

• 打开Eclipse的「Error Log」视图（Window > Show View > Other > General > Error Log），查看是否有和发布相关的详细错误记录。
• 或者修改Eclipse安装目录下的 eclipse.ini 文件，添加以下参数：

  -debug
  -consoleLog
  

  重启Eclipse后尝试发布，控制台会输出更详细的日志，包括空指针的堆栈跟踪，帮助定位具体问题。

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