如何将Maven JEE 7项目迁移至JEE 6以适配JBoss AS6？

你猜的核心方向是对的，但只改依赖版本还不够，得兼顾代码兼容性和容器配置，下面一步步给你拆解：

1. 核心依赖调整 #

首先确实要修改javaee-web-api的版本，而且要确保它的scope是provided——因为JBoss AS6本身已经自带了JEE6的API实现，不需要把API包打进项目里，避免类冲突。

修改后的依赖片段大概是这样：

<dependency>
    <groupId>javax</groupId>
    <artifactId>javaee-web-api</artifactId>
    <version>6.0</version>
    <scope>provided</scope>
</dependency>

如果你的项目里还有其他JEE相关的单独依赖（比如单独的servlet-api、jpa-api），也要统一改成JEE6对应的版本，比如Servlet 3.0（javax.servlet:servlet-api:3.0.1）、JPA 2.0（javax.persistence:persistence-api:2.0），同样设置为provided。

2. 代码兼容性排查 #

JEE7相对于JEE6新增了不少特性，你得检查项目代码里有没有用到这些JEE7专属的内容，比如：

• Servlet 3.1的异步Servlet新方法（比如AsyncContext#setTimeout的重载）
• JPA 2.1的新API（比如EntityManager#unwrap的扩展、存储过程支持）
• CDI 1.1的特性（比如@Priority注解、动态代理增强）
• JSF 2.2的新标签或API（如果用了JSF的话）
  这些都要替换成JEE6兼容的写法，或者去掉依赖这些特性的代码。

3. 项目配置文件调整 #

• web.xml：把根元素的版本从3.1改成3.0，因为JEE6对应Servlet 3.0，AS6不支持3.1的配置。
• persistence.xml：如果用了JPA，要确保persistence的版本是2.0，并且适配JBoss AS6自带的Hibernate版本（通常是Hibernate 3.6.x，对应JPA 2.0），比如provider指定为org.hibernate.ejb.HibernatePersistence。

4. 关于Maven原型 #

其实没有专门的"迁移原型"——原型主要是用来快速新建符合规范的项目，而迁移现有项目更适合手动调整依赖和代码。如果想参考JEE6项目的结构，可以用Maven的webapp原型创建一个空的JEE6项目对比：

mvn archetype:generate -DgroupId=com.example -DartifactId=jee6-demo -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

然后把这个空项目的pom.xml配置、web.xml结构作为参考，调整你现有项目的对应文件。

最后，改完之后一定要在JBoss AS6上做完整的测试，比如启动项目、跑单元/集成测试，排查可能出现的类加载冲突或API不兼容问题。

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