You need to enable JavaScript to run this app. 如何在Eclipse 2021-03中创建Gradle 7.x版本的Java Web应用项目
优惠活动
大模型
产品
解决方案
定价
更多

如何在Eclipse 2021-03中创建Gradle 7.x版本的Java Web应用项目

Eclipse+Gradle Dynamic Web Project 搭建方案

前置准备

确认本地环境已配置好Gradle 7.0.x、AdoptOpenJDK 11、Eclipse 2021-03(已安装WTP组件)、Tomcat 9/10,且Eclipse工作区已完成JDK、Tomcat运行环境的基础配置。

操作步骤

1. 初始化项目目录结构

在本地新建项目根目录,按如下结构创建对应目录和文件:

  • 项目根目录
    • src/
      • main/
        • java/ (存放Java源代码)
        • resources/ (存放classpath级别的配置文件)
        • webapp/ (Web资源根目录,等价于原Dynamic Web Project的WebContent目录)
          • WEB-INF/
            • web.xml (Web项目配置文件)
          • index.jsp (测试用首页文件)
    • build.gradle (Gradle核心配置文件)
    • settings.gradle (Gradle项目配置文件)

2. 编写Gradle配置

settings.gradle 内容

rootProject.name = 'demo-web-project' // 替换为你的项目名称

build.gradle 内容

plugins {
    id 'java'
    id 'war'
    id 'eclipse-wtp' // 核心插件:自动生成Eclipse WTP适配配置,无需手动修改Project Facets
}

group = 'com.example' // 替换为你的组织标识
version = '1.0.0'
sourceCompatibility = '11' // 匹配所用JDK版本

repositories {
    mavenCentral()
}

dependencies {
    // Tomcat 9 配套依赖(Servlet 4.0 规范)
    providedCompile 'javax.servlet:javax.servlet-api:4.0.1'
    providedCompile 'javax.servlet.jsp:javax.servlet.jsp-api:2.3.3'
    
    // 若使用Tomcat 10,需替换为Jakarta EE规范依赖:
    // providedCompile 'jakarta.servlet:jakarta.servlet-api:5.0.0'
    // providedCompile 'jakarta.servlet.jsp:jakarta.servlet.jsp-api:3.0.0'

    // 其他业务依赖直接在此处声明即可,Gradle会自动管理依赖路径
    // implementation 'org.springframework:spring-webmvc:5.3.24'
}

// 可选配置:如需沿用Eclipse默认的WebContent作为Web资源目录,取消下面注释即可
// webappDirName = 'WebContent'

eclipse {
    wtp {
        facet {
            // 配置Project Facets版本,和你的运行环境匹配
            facet name: 'jst.web', version: '4.0'
            facet name: 'java', version: '11'
        }
    }
}

3. 预生成Eclipse配置

在项目根目录打开命令行窗口,执行命令:
gradle eclipseWtp
执行完成后会自动生成Eclipse所需的所有项目配置、WTP部署配置。

4. 导入Eclipse工作区

打开已完成JDK、Tomcat配置的Eclipse工作区,选择导入 > Gradle > Existing Gradle Project,选中项目根目录导入,导入过程中选择本地已安装的Gradle 7.0.x版本即可。

5. 部署验证

导入完成后项目会自动识别为Dynamic Web Project类型,直接将项目添加到Tomcat服务器中,启动服务后访问测试页面即可正常运行,Eclipse会沿用原有逻辑将CATALINA_BASE设置为工作区下的临时文件夹,和你之前的开发习惯完全一致。

常见问题排查

  • 提示web.xml缺失:检查src/main/webapp/WEB-INF/web.xml是否存在,若路径自定义需在build.gradle中指定webXml配置
  • 部署后依赖缺失:所有业务依赖声明为implementation即可,Gradle会自动将对应Jar包放入WEB-INF/lib目录,providedCompile声明的依赖为服务器提供,不会打入部署包
  • 版本兼容报错:确认jst.web的facet版本和Tomcat版本匹配,Tomcat 9支持最高4.0版本,Tomcat 10支持最高5.0版本

内容的提问来源于stack exchange,提问作者MrSnrub

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 02:24:02