如何修改Maven项目pom.xml将内嵌React的Spring Boot REST API打包为可执行Jar包
将React内嵌到Spring Boot可执行Jar的完整配置方案
针对你现有Maven Spring Boot项目中,React代码已存放在src目录下的场景,不需要拆分前后端独立部署,只要按以下逻辑调整pom.xml,就能打出单文件、可独立运行的全量Jar包。
pom.xml 核心配置调整
Maven打全量Jar的核心逻辑是把前端构建流程完全嵌入Maven生命周期,先完成React的生产打包,把静态产物放到Spring Boot默认可识别的静态资源目录,最后由Spring Boot打包插件把前后端代码、内嵌容器、依赖全部整合到同一个Jar中。
需要在pom的<build><plugins>节点下新增3个核心插件配置,替换你实际的React路径即可直接用:
<!-- 前端构建自动化插件:无需本地预装Node/NPM,插件自动拉取对应版本环境执行构建 --> <plugin> <groupId>com.github.eirslett</groupId> <artifactId>frontend-maven-plugin</artifactId> <version>1.15.0</version> <configuration> <!-- 替换为你实际存放在src目录下的React工程根路径 --> <workingDirectory>src/react-app</workingDirectory> <nodeVersion>v20.10.0</nodeVersion> <npmVersion>10.2.3</npmVersion> </configuration> <executions> <execution> <id>init-node-env</id> <phase>generate-resources</phase> <goals> <goal>install-node-and-npm</goal> </goals> </execution> <execution> <id>install-frontend-deps</id> <phase>generate-resources</phase> <goals> <goal>npm</goal> </goals> <configuration> <arguments>install</arguments> </configuration> </execution> <execution> <id>build-react-prod</id> <phase>generate-resources</phase> <goals> <goal>npm</goal> </goals> <configuration> <arguments>run build</arguments> </configuration> </execution> </executions> </plugin> <!-- 资源拷贝插件:把React构建产出的静态文件,同步到Spring Boot可识别的静态资源目录 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <executions> <execution> <id>copy-react-static</id> <phase>prepare-package</phase> <goals> <goal>copy-resources</goal> </goals> <configuration> <outputDirectory>${project.build.outputDirectory}/static</outputDirectory> <resources> <!-- 替换为你React项目的实际构建输出目录:Create React App默认是build,Vite默认是dist --> <resource> <directory>src/react-app/build</directory> </resource> </resources> </configuration> </execution> </executions> </plugin> <!-- Spring Boot打包插件:生成包含内嵌Tomcat、所有依赖、前后端代码的可执行Fat Jar --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <mainClass>你的Spring Boot启动类全路径</mainClass> </configuration> </plugin>
高频踩坑提醒
- 路径层级一定要对齐:不管是React工程的存放路径,还是构建产物的输出路径,都要和你本地实际目录结构一致,路径错位会直接导致打包后前端资源缺失。
- 记得把
src/react-app/node_modules、src/react-app/build、src/main/resources/static这些前端构建生成的临时/产物路径加到.gitignore里,避免重复提交导致版本冲突。 - 生产环境记得把React的接口请求路径改成同源相对路径,避免跨域问题。
带内嵌React的Spring Boot项目标准搭建流程
- 调整项目目录结构:在标准Maven工程的src目录下新建react子目录,把完整React前端代码(含package.json、src、public等核心文件)迁移到该子目录,保证React工程的启动命令可以在该目录下正常执行。
- 按上述配置调整pom.xml,替换实际的工程路径和启动类路径。
- 执行打包命令
mvn clean package,Maven会自动按顺序完成Node环境初始化、前端依赖安装、React生产构建、静态资源同步、后端代码编译、全量Jar打包的全流程,整个过程不需要你本地预装Node环境。 - 运行生成的Jar包,直接用
java -jar 项目名.jar命令启动即可,访问服务端口就能看到前端页面,后端REST接口和前端页面同源访问,不需要额外配置跨域规则。
内容的提问来源于stack exchange,提问作者Percival
相关产品推荐
相关产品推荐

