Gradle Java项目怎么构建WAR包-java教程-PHP中文网

Gradle构建WAR包核心三步：启用war插件（低版本用apply plugin:'war'，高版本用plugins{id'war'}）、创建src/main/webapp目录并放置Web资源、Servlet API依赖设为compileOnly或providedCompile。

gradle java项目怎么构建war包

Gradle Java项目构建WAR包，核心就三件事：加war插件、配好src/main/webapp路径、确保Servlet容器依赖是provided作用域——缺一不可，否则部署后404或启动失败。

必须启用`war`插件并确认插件写法

低版本Gradle（6.x及以前）用apply plugin: 'war'；高版本（7.0+）必须改用plugins { id 'war' }，否则gradle war任务根本不会注册。别只看build脚本能跑通就以为对了——检查终端执行gradle tasks，确认输出里有war和bootWar（如果是Spring Boot）。

plugins块必须放在build.gradle最顶部，不能嵌套在subprojects或allprojects里
如果同时用java插件，顺序无关，但war插件会自动依赖java
别漏掉sourceCompatibility = JavaVersion.VERSION_17这类声明，否则编译可能失败

`src/main/webapp`目录必须存在且被`war`任务识别

Gradle的war插件默认只打包src/main/webapp下的内容（含WEB-INF/web.xml），不读src/main/resources里的静态文件。如果你没这个目录，或者放错了位置（比如建成了src/webapp），生成的WAR里就没有HTML/CSS/JS，访问直接404。

手动创建src/main/webapp/WEB-INF/web.xml（哪怕空文件也行，Spring Boot可省略，但传统Web项目必须）
静态资源（如index.html）必须放在src/main/webapp/下，不是resources
需要额外路径？用war { from 'xxx' }显式追加，例如from 'src/dist' into 'static'

Servlet API依赖必须设为`providedCompile`或`compileOnly`

Tomcat等容器自身提供javax.servlet或jakarta.servlet类，如果把它们打进WAR，运行时大概率报java.lang.ClassCastException: javax.servlet.Filter或ClassNotFoundException——因为类加载器冲突。

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

Spring Boot项目：把spring-boot-starter-tomcat改为providedRuntime（Gradle 7+）或providedCompile（旧版）
传统Java Web项目：用compileOnly 'jakarta.servlet:jakarta.servlet-api:6.0.0'（Jakarta EE 9+）或compileOnly 'javax.servlet:javax.servlet-api:4.0.1'（旧版）
别用implementation或runtimeOnly，那会把API打进WAR

Spring Boot项目额外要继承`SpringBootServletInitializer`

Spring Boot默认打jar，靠内嵌Tomcat启动；打war部署到外部容器时，必须让主启动类继承SpringBootServletInitializer并重写configure()，否则Spring MVC的DispatcherServlet根本不会注册，所有请求都返回404。