Eclipse中Maven Webapp项目重复部署描述符及Java源文件夹缺失问题

一、为什么maven-archetype-webapp默认没有Java源文件夹？ #

maven-archetype-webapp是早期的Maven原型，设计上只默认生成Web应用核心目录（如src/main/webapp），src/main/java、src/test/java这类Java源目录不会自动创建，这是原型本身的特性，并非你的操作错误。

二、手动创建源文件夹后出现重复部署描述符的原因及解决方法 #

手动创建Java源文件夹后，Eclipse未正确关联Maven项目结构，导致Web部署配置与Maven源目录规则冲突，进而出现重复部署描述符。正确做法是让Maven自动管理源目录，而非手动创建：

步骤1：自动生成并识别Java源文件夹 #

• 右键项目 → Maven → Update Project，勾选「Update project configuration from pom.xml」后点击确定，Eclipse会自动创建src/main/java并标记为Java源文件夹。
• 若上述操作无效，可在项目根目录执行Maven命令：

  mvn eclipse:eclipse
  

  执行完成后刷新项目，Eclipse会自动识别源目录。

步骤2：修复重复部署描述符问题 #

1. 删除手动创建的Java目录及相关重复配置。
2. 检查Deployment Assembly配置：右键项目 → Properties → Deployment Assembly，确保仅src/main/java被映射到WEB-INF/classes，删除所有多余的包条目。
3. 清理项目缓存：点击菜单栏 Project → Clean，选择当前项目执行清理，之后再次右键项目 → Maven → Update Project同步配置。

总结 #

你的操作误区是手动创建Java源文件夹，导致Eclipse的Web项目配置与Maven结构冲突。通过Maven的Update功能自动生成并识别源目录，即可避免这类配置冲突问题。

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