Eclipse整合maven详细步骤及问题解决方案

Eclipse整合maven详细步骤及问题解决方案

本来是想学习搭建SSM框架，网上说使用maven项目管理工具更加方便，于是追求高效的我开始走上这条不归路，一步一个坎儿，利用空闲时间折腾了好几天，终于是给弄好了，下面介绍详细步骤：

• 运行环境：Windows10
• 服务器：Tomcat 8.5
• Maven版本：apache-maven-3.5.3
• JDK版本：jdk1.8.0_171
• IDE版本：Eclipse Jee Oxygen

---

jdk下载及配置

jdk安装

• jdk下载地址：[http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html]
• 下载安装版本后，双击运行.exe文件
• 选择jdk安装文件夹，可按自己要求设置，点确定
  
• 点下一步
  
• 等待进度条走完，则安装好jdk，然后选择jre安装文件夹，点下一步
  
• 安装完成，关闭
  

配置环境变量

• 计算机-右键属性-高级系统设置，选择右下角-环境变量
  
• 选择系统变量-环境变量-新建，变量名填：JAVA_HOME；变量值填jdk安装地址：D:\Program Files\Java\jdk1.8.0_171，然后确定保存
  
  -找到系统变量中Path，选中，点击编辑，新建两条路径：%JAVA_HOME%\bin；%JAVA_HOME%\jre\bin，点击确定保存
  
• win+r打开cmd，输入java -version，查看是否配置成功
  

Eclipse中配置jdk

• 打开Eclipse，选择菜单栏window-ppreferences-java-installed JREs，点击add
  
• JRE home选择jdk安装文件夹，其他参数自动识别，点击finish保存
  
• 勾选刚刚添加进来的jdk文件，点击apply and close，至此jdk配置完毕

Tomcat下载及配置

• Tomcat下载地址：[https://tomcat.apache.org/download-80.cgi]

安装配置

• 下载之后，解压到目标目录
  
• 进入目标目录：D:\Program Files\apache-tomcat-8.5.24\bin，双击startup.bat，出现如下画面，证明已经跑起来了
  
• 打开浏览器，地址栏输入：http://localhost:8080/，可以看到服务器可以运行
  

Eclipse配置Tomcat

• 打开Eclipse，选择菜单栏window-ppreferences-server-Runtime Environment，点击add
  
• 选择安装版本，由于刚下载的是8.5版本，所以此处选择Apache Tomcat V8.5，点击next
  
• 选择Tomcat目标文件夹，jre选择工作平台默认不需修改，然后点击finish，apply and exit
  
• 至此Tomcat配置完毕

Maven下载及配置

• maven下载地址：[https://maven.apache.org/download.cgi]

安装配置

• 从网站下载所需版本，解压到目标文件夹
  
• 选择系统变量-环境变量-新建，变量名填：MAVEN_HOME；变量值填maven解压地址：D:\apache-maven-3.5.3-bin\apache-maven-3.5.3，然后确定保存
  
  -找到系统变量中Path，选中，点击编辑，新建路径：%MAVEN_HOME%\bin，点击确定保存
  
• 以管理员方式打开cmd（注意：一定要以管理员方式打开），输入mvn -v，查看是否配置成功，出现如下画面
  

Eclipse整合maven

• Eclipse有的版本是再带maven插件的，但是在新建项目时遇到很多不明所以的问题，所以还是推荐自己安装配置
• 打开Eclipse，选择菜单栏window-ppreferences-Maven-InstallInstallation，点击add
  
• 选择maven解压文件夹，点击finish
  
• 接下来配置maven的本地仓库，打开解压目录，找到conf文件夹，此处位置为：D:\apache-maven-3.5.3-bin\apache-maven-3.5.3\conf，使用记事本打开settings.xml，在localRepository注释下添加语句：

<localRepository>D:\apache-maven-3.5.3-bin\apache-maven-3.5.3\repository</localRepository>

• 中间地址为自己设置的本地仓库位置，若想修改仓库位置，同样在此处修改
  
• 由于maven服务器在国外，下载jar包速度比较慢，所以此处建议选择配置国内阿里云镜像（此处非必须），找到mirrors注释，在后面添加语句：

 <mirrors>
    <id>nexus-aliyun</id>
        <mirrorOf>central</mirrorOf>
        <name>Nexus aliyun</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
  </mirrors>

• 然后回到Eclipse，选择菜单栏window-ppreferences-Maven-User Settings，在Global Settings中选择settings.xml文件位置，Local Repository会自动识别设置好的本地仓库位置
  
• 点击apply and close，至此完成Eclipse与Maven整合

Maven项目实例

新建maven项目

• 接下来创建第一个Maven项目，打开Eclipse，选择菜单栏File-New-Other，找到Maven文件夹下Maven Project，点击next
  
• 选择第二个复选框，设置工程位置，点击next
  
• 选择Archetype，我们此处建立Web项目，在Filter处填web过滤，选择maven-archetype-webapp，点击next
  
• 填写Group Id（公司名称），Artifact Id（项目名称），点击finish
  

index.jsp报错问题

• 项目建立完成，此时出现第一个错误，index.jsp报错，控制台提示错误
  
• 此错误是由于工程项目还未添加tomcat依赖，项目名称右键-Build Path-Configure Build Path-Libraries，点击Add Library
  
• 选择Server Runtime，点击next
  
• 选择安装好的Tomcat，点击finish
  
• 点击apply and close，index.jsp不再报错，项目文件结构自动改变，包括src/main/java，src/main/resources，src/test/java
  

文件结构不一样

• 如果文件结构与此不一致，首先看看Eclipse右上角Open Perspective，默认显示为Java EE，只需要改成Java就好了
  

转换web项目问题

• 此时的项目还不是一个web项目，无法运行，需要将它转换为动态web项目
• 项目名称右键，Properties-Project Facets，勾选Dynamic Web Module，Java，JavaSScript
  
• 最大的问题出现，我们一般使用的Dynamic Web Module为3.0版本，此处默认为2.3，如果直接修改则会提示Dynamic Web Module 3.0 requires Java 1.6 or newer。由于我们之前安装的jdk为1.8版本，所以完全满足要求，按以下步骤操作：
• 关闭Properties菜单，选择菜单栏-Window-Show View-Navigator，以此打开以下几个文件，将其中1.5处都改为1.8，2.3处都改为3.0
  
  
  
• 打开工程下的web.xml，将其中代码修改为，关闭保存：

   <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" 
    id="WebApp_ID" version="3.0">
    </web-app>

• 首先更新项目，项目名称右键，Maven-Update Project，然后再打开Properties-Project Facets，可以看到版本都已经改变
• 控制台依然报错，原因是maven默认的jre版本还未匹配，首先项目右键-Build Path-Configure Build Path-Liberies，选择JRE System Library，点击Edit
  
• 选择平台默认jre版本，也就是我们安装好的1.8版本jdk，点击finish
  
• 然后继续在Properties菜单左侧找到Java Compiler，将其中编译级别修改为1.8，apply and close
  
• 打开Window-Prefereces-Java-Compiler，修改编译级别为1.8，apply and close
  
• 打开maven工程下pop.xml文件，在<build>标签内部添加如下配置文件，保存关闭，然后update project：

        <plugins>  
            <plugin>  
                <groupId>org.apache.maven.plugins</groupId>  
                <artifactId>maven-compiler-plugin</artifactId>  
                <version>2.3.2</version>  
                <configuration>  
                    <source>1.8</source>  
                    <target>1.8</target>  
                </configuration>  
            </plugin>  
        </plugins>

• 这样就把工程中所有涉及到jre版本的地方都统一为我们安装好的版本，避免控制台报错Dynamic Web Module 3.0 requires Java 1.6 or newer，还有一些其他问题报错，不过给忘了，暂时就不写了，最主要是版本的问题，一定要记住每次更改后都要Update Project，才能使配置文件生效，切记切记。

运行问题

• 激动人心的时刻到来了，漫长的煎熬，终于可以开始第一次试运行了，右键index.jsp，Run As-Run on Server，选择安装好的Tomcat服务器，点击next
  
• 将建立好的项目添加到服务其中，点击finish
  
• dangdangdang，成功！！！
  
• 球都嘛得(dei)，可能到这一步的时候会遇到服务器无法启动，提示端口8005，8080，8009被占用，此时一定先打开浏览器，打开网址localhost：8080，是否能打开，如果能打开，就说明端口被此处占用了，只需要进任务管理器，找到Tomcat.exe进程，杀掉。
• 回到Eclipse，重新run一遍，是不是成功了呢？？？