每年三四月份我总会收到一大波“计算机毕业设计”相关的私信其中“旅游信息交流网站”出现的频率特别高。大家觉得旅游类项目有画面感页面好看功能也能凑出来但真正做起来才发现分享、评论、点赞、下单、订单状态流转每一环都能把人逼疯。最近我完整梳理了一个很有代表性的毕设题目——基于SpringBoot的“行走圈”旅游分享与商品交易平台同时它也是一个SpringBootVue实现的全域旅游互动门户。这篇把整个项目的设计思路、核心技术点、实操步骤和踩坑记录一次性讲清楚无论是正在选题的应届生还是打算做全栈项目练手的开发者都能直接拿来参考。1. 项目定位拆解旅游信息交流网站不只是“发帖子”1.1 内容生产与交易闭环的融合点“行走圈”这类项目最核心的一点是把内容社区和电商平台放在同一套体系里。用户既能发布旅行攻略、心得也能浏览目的地路线还能直接购买景区周边和当地特产。单纯的旅游网站到处都是但毕设如果要出彩画面感和业务逻辑缺一不可。从业务架构上看它至少需要四个角色普通游客浏览者、内容创作者、买家、后台管理员。游客可以看热门攻略创作者可以发图文、视频买家把商品加入购物车完成订单流程管理员负责审核内容和处理订单异常。四个角色映射到数据库里就是用户表多了一个role字段映射到权限上就是不同接口需要不同的角色校验。很多同学在前期没有把角色梳理清楚后面做权限越改越乱这就是第一个要避开的坑。1.2 用户旅程与页面流转设计我们顺着一条真实的使用路径来看用户打开首页看到“热门目的地”“最新攻略”“推荐好物”三个区块。点击一篇攻略进入详情页能点赞、评论、收藏也能看到创作者关联的商品推荐。之后进入商城列表筛选“目的地周边”把商品加入购物车提交订单填写配送信息选择在线支付或模拟支付最后在“我的订单”看到状态变化。这条链路看上去简单其实包含了一整套RESTful API设计。前端页面至少需要首页、攻略详情、商城列表、购物车、结算页、订单列表、个人中心、后台管理八个页面。每个页面背后都有独立的Controller和Service所以这套项目非常适合用来展示你对SpringBoot分层的理解。2. 技术选型解析SpringBoot Vue 的组合为什么是解题最优解2.1 前后端分离的核心逻辑选用SpringBoot作为后端、Vue作为前端本质上是把展示和业务彻底分层。后端只输出JSON前端通过axios调用接口使用Vue Router管理页面状态。这样做第一个好处是分工明确方便你一边写接口一边调页面第二个好处是答辩时可以讲清楚“前后端通过RESTful API通信”这种标准开发流程评委很吃这一套。不过前后端分离并不等于前后端割裂。你要在自己的项目里把接口文档、字段命名、时间格式、状态码约定都在一开始列好。比如约定所有接口返回统一格式{ code: 200, message: success, data: {} }前端拿到code后再决定跳转逻辑而不是让前端去解析各种乱七八糟的异常堆栈。我见过太多项目在联调阶段因为返回格式不统一吵来吵去最后熬夜补接口文档。早定规范效率会高很多。2.2 数据存储、文件服务与搜索引擎的选型思路数据库首选MySQL这是最稳妥的毕业设计方案网上资料多、排查问题方便。如果高校要求使用国产数据库可以换成金仓后面我会专门讲读写分离配置。需要注意的是SpringBoot MyBatis Plus的组合非常适合这类项目MyBatis Plus把单表CRUD封装得极其简单你只需要写好实体类继承BaseMapper就能少写大量重复SQL。图片和附件上传通常是最容易翻车的地方。本地磁盘存储虽然简单但换电脑、换服务器就得迁移文件答辩演示时容易出问题。更推荐的方案是把图片放到MinIO里MinIO是开源的对象存储服务支持S3协议在Windows上一条命令就能启动和SpringBoot的整合也很简单。它既能体现你对分布式文件存储的理解也不会增加太多工作量。2.3 依赖版本搭配建议先说一个很多人头疼的点SpringBoot版本不是越高越好。当前很多教程还停留在2.x版本如果你直接创建Spring Boot 3.x的项目会发现原来用的javax.包全部变成了jakarta.部分老版本MyBatis Plus、JWT工具类也会不兼容。我建议第一个人完整的毕设项目使用Spring Boot 2.7.18对应JDK 8或11依赖生态最稳。下面是一份我实测过的依赖清单依赖版本选择说明Spring Boot2.7.18稳定、兼容javaxMyBatis Plus3.5.7单表CRUD、分页好用MySQL8.0.34常用版本MinIO8.5.12兼容S3对象存储JWTjjwt0.11.5生成与校验tokenVue3.4.x Vite构建速度快Vue Router4.x支持动态路由如果不知道怎么固定版本Maven默认会拉取最新版一旦出现不兼容代码先检查版本。表格内版本是我当时实测的组合不代表唯一答案但照着用基本不会出错。3. 从零到一的SpringBoot核心实现3.1 初始化工程与Maven依赖搭建打开IDEA选择Spring Initializr创建项目Group一般填com.exampleArtifact填walking-circle打包方式jarJava版本根据Spring Boot版本选择8或11。创建完成后先把pom.xml里的关键依赖补上dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.7/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.34/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-api/artifactId version0.11.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-impl/artifactId version0.11.5/version /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt-jackson/artifactId version0.11.5/version /dependency这里特别提醒MySQL驱动坐标在新版本中改成了com.mysql:mysql-connector-j如果你用的是旧坐标最好指定一个具体版本否则Maven会告警甚至拉错包。启动类加MapperScan注解扫描mapper包然后在application.yml中配置数据库连接、端口、上传大小server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/travel?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: root servlet: multipart: max-file-size: 20MB max-request-size: 100MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl设置serverTimezoneAsia/Shanghai非常重要否则查询时间字段经常出现八个小时的偏移。之前有个同学在答辩现场演示时后台显示的订单时间比实际少了8小时就是少了这个参数。3.2 用户鉴权与JWT实现细节用户注册登录是每个系统都绕不开的模块。我不建议一上来就引入Spring Security虽然它很强大但对毕设项目来说学习成本偏高且配置一旦出错很难排查。更推荐的做法是登录成功后生成JWT前端把token放在请求头里后端用一个拦截器统一校验token并把用户信息注入到当前上下文。JWT结构分成三段Header、Payload、Signature。Header里声明加密算法Payload里放用户id、用户名、过期时间Signature用密钥对前两段签名。后端不需要保存会话状态分布式环境下也好扩展。核心代码如下public class JwtUtils { private static final String SECRET your-secret-key-please-change-it; private static final long EXPIRATION 24 * 60 * 60 * 1000L; public static String createToken(Long userId, String username) { return Jwts.builder() .setSubject(username) .claim(userId, userId) .setExpiration(new Date(System.currentTimeMillis() EXPIRATION)) .signWith(SignatureAlgorithm.HS256, SECRET) .compact(); } public static Claims parseToken(String token) { return Jwts.parser().setSigningKey(SECRET).parseClaimsJws(token).getBody(); } }如果使用jjwt 0.11.5signWith方法需要传入Key对象建议用Keys.hmacShaKeyFor(SECRET.getBytes())生成。这段代码能在答辩中展示你对无状态认证的理解。拦截器实现上继承HandlerInterceptor重写preHandle方法放行登录、注册和公开的攻略/商品查询接口其余接口校验token。注册拦截器时需要注意切静态资源和前端页面的请求。如果是纯前后端分离项目静态资源通常交给Vue处理后端拦截器只管/api/**路径即可。3.3 攻略发布、商品与订单模块的接口设计这个部分是整个项目含金量所在。计划模块拆成“内容中心”和“交易中心”两块模块典型接口说明内容中心GET /api/notes攻略列表支持分页、关键词内容中心GET /api/notes/{id}攻略详情内容中心POST /api/notes发布攻略内容中心POST /api/notes/{id}/comment评论攻略内容中心POST /api/notes/{id}/like点赞/取消点赞交易中心GET /api/goods商品列表交易中心POST /api/orders创建订单交易中心GET /api/orders/{id}查询订单状态以创建订单为例除了生成订单号、计算总价还要进行库存的预扣减。最稳妥的做法是在Service层开启事务先查询商品库存如果库存充足则扣减库存并插入订单记录任何一个环节失败都回滚。订单号不要用自增id用时间戳加随机数生成“yyyyMMddHHmmss 6位随机数”这样业务上可读性好也能防止被遍历。Transactional public OrderVO createOrder(OrderCreateRequest request) { Goods goods goodsMapper.selectById(request.getGoodsId()); if (goods null || goods.getStock() request.getQuantity()) { throw new BusinessException(库存不足); } String orderNo generateOrderNo(); Order order new Order(); order.setOrderNo(orderNo); order.setUserId(request.getUserId()); order.setTotalAmount(goods.getPrice().multiply(BigDecimal.valueOf(request.getQuantity()))); order.setStatus(0); // 0待付款 orderMapper.insert(order); goods.setStock(goods.getStock() - request.getQuantity()); goodsMapper.updateById(goods); return OrderVO.from(order); }这段代码在答辩时非常实用把Spring事务、库存一致性、BigDecimal计算都串起来了。注意金额不要用double否则会出现0.10.2不等于0.3的尴尬问题。在发布攻略模块建议用Markdown编辑器保存内容。数据库里同时存contentMd和contentHtml详情页直接渲染HTML列表页只展示摘要。这样既保证用户体验还能避免每次请求都要做一次Markdown转换后端压力小很多。4. Vue端实现与前后端联调实操4.1 Vue3 Vite的项目创建与路由设计前端部分我强烈建议直接上Vue3 Vite启动速度和开发体验都比Vue CLI好很多。创建项目可以用npm create vite或npm create vue选择Router和Pinia省去后面手动配置的麻烦。用Vite创建的项目目录结构清晰src/router/index.js用来定义路由。“行走圈”的前端路由我的设计大致如下const routes [ { path: /, name: Home, component: Home }, { path: /note/:id, name: NoteDetail, component: NoteDetail, props: true }, { path: /goods, name: GoodsList, component: GoodsList }, { path: /cart, name: Cart, component: Cart }, { path: /checkout, name: Checkout, component: Checkout }, { path: /orders, name: OrderList, component: OrderList }, { path: /login, name: Login, component: Login }, { path: /register, name: Register, component: Register }, { path: /admin, name: Admin, component: AdminLayout, meta: { role: admin } } ]如果你做动态路由思路是登录成功之后根据role字段用router.addRoute()把后台页面动态加进来并在路由导航守卫里面判断用户角色。这部分内容也是面试官喜欢问的但毕设项目里静态路由加一个meta.role判断就已经足够。4.2 状态管理与接口请求封装Pinia是Vue3官方推荐的状态管理库比Vuex的TypeScript支持和代码拆分体验好很多。把用户信息、token、购物车数量挂到store里页面刷新时再从localStorage恢复。接口请求我习惯建一个utils/request.js统一封装axiosimport axios from axios import { useUserStore } from /stores/user const request axios.create({ baseURL: /api, timeout: 10000 }) request.interceptors.request.use(config { const store useUserStore() if (store.token) config.headers.Authorization Bearer ${store.token} return config })这里有个细节如果前端项目用Vite devServer代理baseURL可以直接写/api后端不用处理跨域。如果前后端分开部署需要在vite.config.js里配置proxyserver: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } }这个方案把跨域问题挡在了开发环境之外线上再用Nginx统一转发是最推荐的联调方式。4.3 图片上传与商品图片预览的实现细节攻略封面和商品图片上传Vue页面里用el-upload或原生input。上传时通过minioService拿到上传URL再调用后端接口。后端接收MultipartFile后校验文件类型和大小生成随机文件名最后丢给MinIO。前端预览商品图片时如果后端返回的是MinIO对象地址直接拼上endpoint和bucket路径就能用。但要注意MinIO默认的bucket访问权限是私有的需要设置bucket policy为public或者由后端生成临时访问链接。我建议演示时直接做成public省去临时签名链接的处理。如果涉及PDF文件预览比如旅游攻略的电子手册Vue里最简单的办法是用iframe或embed嵌入对象地址。网上说用file.readAsDataURL转base64也可以但大文件转base64后URL会很长反而容易出问题。直接用后端返回的浏览器可访问地址最省心。5. 部署、调试与常见问题实录5.1 将Vue打包进SpringBoot的两种方式毕业设计演示通常在本地跑起来就行最省事的方式是把前端打包后的dist目录塞进SpringBoot的static目录这样一个应用就能跑通全部功能。打包命令是npm run build然后把dist下的所有文件复制到src/main/resources/static下重新启动后端浏览器访问http://localhost:8080就能看到一个完整站点。但这种方式有一个坑当Vue Router使用history模式时用户直接访问/note/12会返回404因为SpringBoot的Tomcat找不到这个路径对应的静态资源。解决方案有两个一是把路由改成hash模式URL上多一个#号但看起来不够专业二是在后端加一个视图控制器把前端路由全部转发到index.html。我更推荐第二种Configuration public class WebConfig implements WebMvcConfigurer { Override public void addViewControllers(ViewControllerRegistry registry) { registry.addViewController(/{spring:[^\\.]*}) .setViewName(forward:/index.html); } }这个配置对单页应用的刷新问题非常管用。当然如果以后想把前后端完全拆开部署Nginx配置也很简单把dist目录交给Nginx托管/api路径反向代理到SpringBoot服务再配置一个try_files回退到index.html。这是面试官比较认可的生产架构。5.2 版本过高、依赖冲突和启动报错速查毕业设计里最常遇到的几个问题我整理了一个速查表现象原因处理方法项目启动报ClassNotFoundException依赖版本不兼容固定SpringBoot版本与依赖版本报错javax.servlet vs jakarta.servletSpringBoot 3.x用了Jakarta标准要么把代码中javax改成jakarta要么降回2.x端口占用8080被其他程序占用改server.port或用kill进程Maven依赖下载慢/失败网络源不好换阿里云镜像设置IDEA Maven Repository查询数据中文乱码数据库编码不是utf8URL加characterEncodingutf8建库时用utf8mb4上传大文件报400multipart默认限量1MB在application.yml中调大max-file-size和max-request-size我反复强调版本锁定是因为常见的“本地能跑同学电脑跑不了”基本都跟版本号漂移有关。Maven默认会在没有版本号时挑选最新版本而最新版本往往改了不少行为。全部用固定版本并写在pom里能保证项目换台机器依然构建成功。5.3 基于金仓数据库的读写分离配置参考有些学校强制要求使用国产数据库KingbaseES金仓是一个常见选项兼容MySQL或PostgreSQL语法。更关键的是毕业设计如果加入读写分离能成为一大亮点。所谓读写分离就是主库处理插入、更新、删除从库分担查询压力。用MyBatis Plus增强的dynamic-datasource-spring-boot-starter可以很方便实现。先在pom中加入依赖然后在application.yml中配置主从数据源spring: datasource: dynamic: primary: master datasource: master: driver-class-name: com.kingbase8.Driver url: jdbc:kingbase8://localhost:54321/travel username: system password: 123456 slave: driver-class-name: com.kingbase8.Driver url: jdbc:kingbase8://localhost:54322/travel username: system password: 123456 strict: true之后在查询密集的Service或Mapper方法上加DS(slave)注解写操作默认走Master这样就把读和写分开了。为了验证效果可以给主从库设置不同的数据或者直接看日志里的数据源切换。注意金仓驱动类不是com.mysql.jdbc.Driver别搞混了。如果你不想为读写分离增加复杂度那至少要保证连接池配置正确把Spring Boot默认的HikariCP说清楚它为什么快、为什么适合高并发也能体现基本功。6. 答辩展示与项目扩展建议6.1 如何把项目亮点讲清楚答辩时最容易犯的错是一上来就念代码。评委更想听你如何分析问题和做技术选型。我建议按这个顺序讲先讲清楚“行走圈”要解决什么问题然后讲系统的核心业务链路再说“我用了什么方案解决什么问题”最后现场演示。例如你可以说用户身份鉴别使用JWT是为了让后端不保存会话状态便于横向扩展文件上传接入MinIO是为了把文件职责从应用服务中剥离订单创建加事务是为了保证库存和订单数据的一致性商品列表加Redis缓存是为了应对热点数据查询压力。哪怕暂时没有缓存你也可以在答辩中提出“后续可引入缓存”但是前面这几个实现闭环比口播一百个技术名词更有说服力。6.2 三个值得扩展的增值功能如果时间充裕我建议优先做这几个扩展攻略搜索引入HanLP分词先把攻略标题和正文分词保存关键词再按关键词做全文匹配效果比like %旅游%好得多点赞、评论、下单消息通过ActiveMQ异步处理把系统削峰解耦的机制体现出来在攻略详情页嵌入腾讯地图展示目的地坐标和相关景点标记让“全域旅游互动门户”真正有空间感。这三个功能都不是独立项目但每加一个都能让你的设计和数据库表多出几张关联表也会让答辩内容更饱满。我强调一句话毕设不是功能越多越好而是每个模块你能讲清楚它是做什么的、为什么这样设计、出了问题怎么排查。这三点做到位评委基本都会认可。其实走到这一步“行走圈”这个项目已经不再是一台“旅游信息交流网站”那么简单它把用户、内容、商品、订单、后台管理都揉在了一起这种“内容交易”的双循环结构放到真实的旅行平台上也很常见。我自己在拆解类似项目时最大的体会是别被技术名词吓到先把一条业务路径完整打通再往旁边扩展你会发现SpringBoot和Vue的组合远比想象中从容。希望上面这些思路和踩坑记录能帮你的毕设少走几步弯路。