将Java Web应用从JBoss迁移至WebSphere：Maven构建异常求助

Hey there, let’s tackle these migration headaches step by step—moving from JBoss to WebSphere can throw some classpath curveballs, but we can work through them systematically.

1. 先搞定Maven构建的依赖错误 #

WebSphere自带大量自身库（比如Servlet API、JTA，甚至有时候会包含旧版Spring），这些很容易和应用引入的依赖产生冲突。你可以这么做：

• 把容器提供的依赖标记为provided：对于Servlet、JSP、JEE注解（javax.annotation-api）这类API，将它们的Maven <scope>设置为provided。这会告诉Maven不要把这些包打包进WAR包，因为WebSphere会在运行时提供它们。
• 通过依赖树排查冲突：在项目根目录执行mvn dependency:tree -Dverbose命令，查找Spring库（spring-core、spring-webmvc）、commons-logging等常见依赖的重复或版本不匹配问题。在pom.xml中用<exclusions>标签剔除冲突的依赖。
• 统一Spring版本：确保所有Spring相关依赖（spring-core、spring-context、spring-web、spring-webmvc）使用完全相同的版本——混合不同版本是注解处理问题的经典诱因。

2. 修复DispatcherServlet中@Resource注解被忽略的异常 #

这个错误几乎都是类加载器冲突导致的：Spring的注解类被两个不同的类加载器（WebSphere系统类加载器和应用类加载器）加载。解决方法如下：

• 确保Spring库由应用类加载器加载：将Spring核心依赖（spring-core、spring-webmvc等）的<scope>保持为compile，这样它们会由应用类加载器加载，而非WebSphere的系统类加载器。如果WebSphere的共享库中存在旧版Spring，移除它或者调整类加载顺序为"Parent Last"（让WebSphere优先使用应用自带的库）。
• 验证@Resource注解的正确性：仔细检查你是否统一使用javax.annotation.Resource（JEE标准）或org.springframework.stereotype.Resource（Spring专属）注解。如果使用JEE版本，确保javax.annotation-api被标记为provided，以匹配WebSphere的实现。
• 显式开启注解处理：在Spring配置文件（XML或Java配置）中，确保已启用组件扫描和注解支持：

  <!-- 在dispatcher-servlet.xml中 -->
  <context:component-scan base-package="com.your.app.package" />
  <context:annotation-config />
  

  或者用Java配置：

  @Configuration
  @ComponentScan(basePackages = "com.your.app.package")
  public class WebConfig implements WebMvcConfigurer {
      // ... 其他配置
  }
  

3. 排查Error #2（迁移常见坑点） #

既然你没给出Error #2的具体细节，这里列出JBoss迁移到WebSphere时最常见的类路径相关问题：

• ClassNotFoundException：检查pom.xml是否遗漏依赖，或者不小心把必需的依赖标记为provided。执行mvn dependency:list确认所有需要的jar包都已包含。
• ClassCastException：这是类加载器冲突的明确信号。通过依赖树查找重复类的来源，然后剔除冲突版本。
• JNDI查找失败：WebSphere的JNDI命名规则和JBoss不同（比如jdbc/YourDataSource vs java:jboss/datasources/YourDataSource）。更新Spring配置或web.xml以匹配WebSphere的JNDI名称。

快速总结 #

先从修复Maven依赖冲突入手，统一所有Spring版本，调整容器提供依赖的scope，必要时修改类加载器设置。一步步来——类路径问题通常都和一致性有关！

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