当前位置：首页 > article >正文

将 Vue 项目打包后部署到 Spring Boot 项目中的全面指南

article 2026/4/9 12:09:12

将 Vue 项目打包后部署到 Spring Boot 项目中的全面指南

在现代 Web 开发中，前后端分离架构已经成为主流。然而，在某些场景下，我们可能需要将前端项目（如 Vue）与后端项目（如 Spring Boot）集成部署。

本文将详细介绍如何将 Vue 项目打包后部署到 Spring Boot 项目中，包括必要的配置步骤和注意事项。

目录

将 Vue 项目打包后部署到 Spring Boot 项目中的全面指南
项目概述
前提条件
步骤一：配置 Vue 项目
1.1 修改 `vite.config.js` 文件
1.2 打包 Vue 项目

步骤二：搭建 Spring Boot 项目
2.1 创建 Maven 项目
2.2 修改 `pom.xml` 文件
2.3 配置 `application.yml` 文件
2.4 编写启动类
2.5 编写跳转控制器

步骤三：整合 Vue 项目到 Spring Boot 项目
3.1 创建静态资源和模板目录
3.2 复制 Vue 打包文件到 Spring Boot 项目
3.3 修改 `index.html` 中的资源路径

步骤四：启动并测试
附加配置：修改前端后端服务地址
附加配置：修改前端 URL 转发
Nginx配置[可选]
1.基本思路
2.示例配置
3.重启
4.Vite配置

常见问题及解决方案
总结

项目概述

本文将指导你如何将一个基于 Vue 3 的前端项目打包后，部署到一个基于 Spring Boot 的后端项目中。通过这种方式，你可以将前后端项目集成在一个应用中，简化部署流程。

前提条件

已安装 Node.js 和 npm
已安装 Java 和 Maven
已安装 Spring Boot 和 Vue CLI 或 Vite（本文以 Vite 为例）
基本的 Java 和 JavaScript 知识

步骤一：配置 Vue 项目

1.1 修改 `vite.config.js` 文件

为了确保 Vue 项目在打包后能够正确引用静态资源，需要修改 vite.config.js 文件，添加 base:'./' 配置。

// vite.config.js
import { fileURLToPath, URL } from 'node:url'
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'export default defineConfig({plugins: [vue()],resolve: {alias: {'@': fileURLToPath(new URL('./src', import.meta.url))}},base: './'
})

1.2 打包 Vue 项目

在 Vue 项目根目录下运行以下命令进行打包：

npm run build

打包完成后，会在项目根目录下生成一个 dist 文件夹，里面包含了编译后的静态文件。

在这里插入图片描述

步骤二：搭建 Spring Boot 项目

2.1 创建 Maven 项目

使用 Maven 创建一个新的 Spring Boot 项目。你可以使用 Spring Initializr 来快速生成项目结构。

2.2 修改 `pom.xml` 文件

在 pom.xml 中添加必要的依赖，包括 spring-boot-starter-thymeleaf 和 spring-boot-starter-web。

<!-- pom.xml -->
<dependencies><!-- Thymeleaf [可选,不建议]--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId></dependency><!-- Spring MVC --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- Lombok --><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><!-- Spring Boot Starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><!-- Test --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
</dependencies>

2.3 配置 `application.yml` 文件

在 src/main/resources 目录下创建或修改 application.yml 文件，配置 Thymeleaf 和静态资源路径
[可以不用Thymeleaf模板引擎]。

# application.yml
server:port: 8080spring:web:resources:static-locations: classpath:/static/, classpath:/public/, classpath:/resources/,classpath:/META-INF/resources/mvc:static-path-pattern: /**# 实测用了Thymeleaf会导致vue某些布局出现一点点问题,建议不用
#    thymeleaf:
#      mode: HTML
#      cache: false
#      prefix: classpath:/templates/

2.4 编写启动类

创建主启动类 Main.java：

// src/main/java/demo/Main.java
package demo;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class Main {public static void main(String[] args) {SpringApplication.run(Main.class, args);}
}

2.5 编写跳转控制器

创建控制器 PageController.java 以处理页面跳转：

// src/main/java/jkw/controller/PageController.java
package jkw.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;@Controller
public class PageController {// 前台页面@RequestMapping("/")public String FrontIndex() {return "forward:./index.html";// 重定向到前端首页}
}

步骤三：整合 Vue 项目到 Spring Boot 项目

3.1 创建静态资源和模板目录

在 src/main/resources 目录下创建 static 和 templates[不用Thymeleaf可以不创建templates] 文件夹，分别存放静态文件和动态页面。

3.2 复制 Vue 打包文件到 Spring Boot 项目

将 Vue 项目 dist 文件夹中的 assets 和 favicon.ico 文件复制到 static/ 目录下。

将 dist 文件夹中的 index.html 复制到 templates/ 目录下。

3.3 修改 `index.html` 中的资源路径

打开 index.html，修改资源引用路径：

<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"><link rel="icon" href="/favicon.ico"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Vite App</title><script type="module" crossorigin src="/assets/index-1973819a.js"></script><link rel="stylesheet" href="/assets/index-4afc3c58.css"></head><body><div id="app"></div></body>
</html>

确保所有资源路径都以 / 开头，这样 Spring Boot 才能正确找到静态资源。

步骤四：启动并测试

启动 Spring Boot 项目：

mvn spring-boot:run

在浏览器中访问 http://localhost:8080/，你应该能够看到 Vue 项目的页面。

附加配置：修改前端后端服务地址

在 Vue 项目的 .env.development 文件中，修改 TARGET 为正式环境后端服务 API 根地址：

# just a flag
ENV = 'development'# backend api
TARGET = 'http://localhost:9000/'

附加配置：修改前端 URL 转发

方法一
修改 .env 文件，将 VUE_APP_BASE_API 设置为空：

# base api#VUE_APP_BASE_API = '/api'VUE_APP_BASE_API = ''

原因：前后端独立部署时，前端会有一个转发配置 vue.config.js。但当部署到 Spring Boot 后，这个转发配置就无效了，必须将其去掉，否则所有对后端的请求都会带着 api 前缀，导致 404 错误。

方法二

也可以通过Nginx伪静态控制后端接口往/api转发到本地8080

Nginx配置[可选]

1.基本思路

静态资源：由 Nginx 直接提供，路径为 /。
API 请求：所有以 /api 开头的请求被转发到后端 Spring Boot 服务（本地 8080 端口）。
其他请求：默认返回 Vue 应用的 index.html，由前端路由处理。

2.示例配置

假设你的 Vue 和 Spring Boot 项目都部署在同一个服务器上，Nginx 配置文件（通常位于 /etc/nginx/sites-available/default 或 /etc/nginx/conf.d/your_site.conf）可以如下配置：

server {listen 80;server_name your_domain.com;  # 替换为你的域名或IProot /path/to/your/vue/dist;  # Vue 项目的 dist 目录index index.html index.htm;# 处理静态资源location / {try_files $uri $uri/ /index.html;}# 仅转发以 /api 开头的请求到后端 Spring Boot 服务location ^~ /api/ {proxy_pass http://localhost:8080/api/;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;# 可选：处理 WebSocket（如果需要）proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";}# 可选：处理其他反向代理需求# location /other_proxy/ {#     proxy_pass http://other_service/;# }
}

3.重启

重新加载 Nginx 配置
在修改完 Nginx 配置文件后，测试配置是否正确：

sudo nginx -t

如果没有错误，重新加载 Nginx：

sudo systemctl reload nginx

4.Vite配置

Vite 配置调整
为了确保前端 Vue 应用在构建时能够正确处理 API 请求的路径，需要调整 Vite 的配置。

修改 base 和 publicPath
在 vite.config.js 中，设置 base 为 /，确保静态资源路径正确：

// vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'export default defineConfig({plugins: [vue()],base: '/',  // 设置为根路径build: {// 可选：设置输出目录outDir: 'dist',// 可选：其他构建选项},// 其他配置...
})

配置代理（开发环境）

// vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'export default defineConfig({plugins: [vue()],base: '/',server: {proxy: {'/api': {target: 'http://localhost:8080',  // 后端 Spring Boot 服务地址changeOrigin: true,rewrite: (path) => path.replace(/^\/api/, '')  // 可选：根据需要重写路径}}},// 其他配置...
})

配置代理（生产环境）
在生产环境中，由于 Nginx 已经处理了 /api 的转发，因此无需在 Vite 配置中额外处理。但是，确保前端代码中的 API 请求路径以 /api 开头。例如：

// 示例：使用 Axios 进行 API 请求
import axios from 'axios'axios.defaults.baseURL = '/api'// 现在，所有 Axios 请求都会自动加上 /api 前缀
axios.get('/users').then(response => {console.log(response.data)})

常见问题及解决方案

*资源路径错误
*：确保 index.html 中的资源路径正确，并且 Spring Boot 的静态资源路径配置正确。
跨域问题：如果前后端分离部署，需要配置 CORS 策略。
缓存问题：在开发过程中，清理浏览器缓存或使用无缓存模式进行测试。
权限问题：确保 Spring Boot 项目有权限访问 Vue 项目的静态资源。

总结

通过以上步骤，你可以将 Vue 项目打包后部署到 Spring Boot 项目中，实现前后端项目的集成。这种方式简化了部署流程，但也带来了一些挑战，如资源路径配置和静态资源管理。
根据具体需求，你可能需要进一步优化配置，例如使用 Spring Boot 的静态资源处理机制来管理前端资源，或者使用更复杂的构建工具来处理前端和后端的集成。