You need to enable JavaScript to run this app. 如何修改Maven项目pom.xml将内嵌React的Spring Boot REST API打包为可执行Jar包
优惠活动
大模型
产品
解决方案
定价
更多

如何修改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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.18 01:36:02