作为一名刚完成毕业设计的过来人我深知从零开始搭建一个完整项目时的迷茫。尤其是“旅游网站”这类看似常见但涉及面广的课题新手很容易在技术海洋里迷失方向。今天我就把自己踩过的坑和总结的经验梳理成一份从零到一的实战笔记希望能帮你少走弯路高效完成一个结构清晰、代码规范的毕业设计。1. 新手常见误区为什么你的项目总是一团乱麻在开始动手之前我们先看看几个典型的“翻车”现场这能帮你避开很多坑。误区一技术选型“追新”或“大杂烩”。看到新技术就想用今天学点React明天又想试试Go结果每个都只懂皮毛项目成了各种技术的试验场耦合严重难以维护。误区二前后端不分家。很多同学图省事用JSP或Thymeleaf把HTML、Java和SQL全写在一起。这在小型项目中看似快捷但一旦功能增加代码会变得极其臃肿前端一个样式改动可能影响后端逻辑调试起来如同噩梦。误区三忽视架构与设计。直接开写想到什么功能就加什么代码。没有模块划分用户管理、订单处理、景点展示的代码混在一起导致后期添加一个“用户收藏”功能都不知道该往哪个文件里塞。误区四只关注功能实现忽略安全与部署。登录密码用明文存储SQL语句直接拼接项目在本地跑起来就万事大吉。等到答辩演示时老师一问安全问题或者换个环境部署就各种报错直接暴露了基础不牢。2. 技术选型为什么是 Spring Boot Vue MySQL对于毕业设计我们的核心目标是在有限时间内用成熟、稳定、资料丰富的技术构建一个结构清晰、易于演示和扩展的项目。下面这个组合是我实践后认为最合适的。后端Spring Boot。它简直是Java后端的“新手福音”。内嵌Tomcat服务器无需复杂配置一个main方法就能启动。它提供了强大的自动配置和起步依赖比如要连接数据库只需在pom.xml引入spring-boot-starter-data-jpa在application.yml里配一下URL就行。这让我们能专注于业务逻辑而不是繁琐的XML配置。前端Vue.js。相比于React和AngularVue的学习曲线更平缓中文文档极其友好。其核心库只关注视图层易于与其它库或已有项目整合。使用Vue CLI可以快速搭建项目结构组件化开发让页面如导航栏、景点卡片可以复用大大提升开发效率。数据库MySQL。关系型数据库的经典选择安装简单图形化管理工具如Navicat、Workbench丰富对于旅游网站的用户、订单、景点等存在明确关系的数据用MySQL建模非常直观。而且Spring Data JPA能极大简化对它的操作。对比其他轻量级方案比如全栈用Node.jsExpress EJS模板或PythonDjango。它们确实也很快但考虑到大部分高校的课程以Java为主选择Spring Boot能更好地体现你的课程学习成果技术栈也更符合主流企业要求为简历加分。3. 核心模块设计与实现思路一个基础的旅游网站可以拆解为以下几个核心模块每个模块职责清晰通过API接口通信。用户认证模块这是系统的门户。采用“手机号/邮箱密码”注册登录。密码绝不能明文存储使用Spring Security JWTJSON Web Token是实现无状态认证的黄金组合。用户登录成功后后端生成一个加密的Token返回给前端前端后续请求都在HTTP头中携带此Token以证明身份。景点信息管理模块这是网站的内容核心。设计一个ScenicSpot实体包含ID、名称、描述、地址、价格、图片URL等字段。提供增删改查CRUD接口后台管理员可以使用这些接口管理景点。前端则主要调用查询接口以列表或详情页形式展示。订单流程模块这是业务的闭环。核心实体是Order关联用户UserID和景点SpotID包含订单号、创建时间、总价、状态如待支付、已支付、已取消等。流程用户选择景点 - 前端调用创建订单接口 - 生成待支付订单 - 用户支付毕业设计可模拟支付- 更新订单状态。这里要特别注意事务管理确保数据一致性。4. 关键代码示例与Clean Code实践理论说再多不如看代码。这里给出两个最关键的代码片段并遵循简洁、可读的原则。1. JWT工具类与登录接口首先在pom.xml引入JWT依赖如jjwt。然后创建一个工具类来生成和验证Token。Component public class JwtUtil { // 从配置文件中读取密钥和过期时间 Value(${jwt.secret}) private String secret; Value(${jwt.expiration}) private Long expiration; // 生成Token将用户ID和用户名存入 public String generateToken(String userId, String username) { Date now new Date(); Date expiryDate new Date(now.getTime() expiration); return Jwts.builder() .setSubject(userId) // 通常用userId作为主体 .claim(username, username) // 自定义声明 .setIssuedAt(now) .setExpiration(expiryDate) .signWith(SignatureAlgorithm.HS512, secret) // 使用HS512算法和密钥签名 .compact(); } // 从Token中解析用户ID public String getUserIdFromToken(String token) { Claims claims Jwts.parser() .setSigningKey(secret) .parseClaimsJws(token) .getBody(); return claims.getSubject(); } // 验证Token是否有效 public boolean validateToken(String token) { try { Jwts.parser().setSigningKey(secret).parseClaimsJws(token); return true; } catch (Exception e) { // Token过期或无效 return false; } } }接着在登录控制器中调用它RestController RequestMapping(/api/auth) public class AuthController { Autowired private UserService userService; Autowired private JwtUtil jwtUtil; PostMapping(/login) public ResponseEntity? login(RequestBody LoginRequest request) { // 1. 验证用户密码密码已在存储时加密此处需对比加密后的密文 User user userService.authenticate(request.getUsername(), request.getPassword()); if (user null) { return ResponseEntity.badRequest().body(用户名或密码错误); } // 2. 生成JWT Token String token jwtUtil.generateToken(user.getId().toString(), user.getUsername()); // 3. 返回Token及必要用户信息避免返回密码等敏感信息 LoginResponse response new LoginResponse(token, user.getUsername(), user.getEmail()); return ResponseEntity.ok(response); } }2. 全局跨域配置与安全配置前后端分离项目跨域CORS是必解问题。在Spring Boot中一个配置类就能搞定。Configuration public class WebConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/api/**) // 对所有/api开头的接口 .allowedOrigins(http://localhost:8080) // 允许前端项目地址 .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) // 允许的HTTP方法 .allowedHeaders(*) // 允许所有头 .allowCredentials(true); // 允许携带Cookie等凭证 } }5. 性能与安全性这些细节让你更专业功能跑通只是第一步以下几点能让你的项目在答辩时脱颖而出。SQL注入防护坚决不要用字符串拼接SQL使用Spring Data JPA方法名查询或Query注解或MyBatis使用#{}占位符它们底层都使用预编译语句PreparedStatement能从根本上杜绝注入。密码加密存储绝对不要用MD5更别提明文。使用BCryptPasswordEncoder它是专门为密码存储设计的哈希算法每次加密结果都不同且自带盐值Salt安全性高。在Spring Security中配置非常方便。接口幂等性对于创建订单、支付等关键操作要防止用户重复提交。简单做法是前端在提交后禁用按钮但后端更可靠。可以为每个订单请求生成一个唯一令牌Token第一次提交时校验并删除令牌后续重复提交会因令牌失效而失败。基础输入验证无论是前端还是后端都要对用户输入进行验证。后端使用Valid注解配合NotBlank、Email等注解在控制器入口处就拦截非法数据。6. 生产环境避坑指南从开发到部署的最后一公里本地运行顺利部署上线却错误百出以下是几个常见坑点。Git提交规范从第一天就养成好习惯。master/main分支只存稳定版本。为新功能创建feature/xxx分支开发完合并。提交信息写清楚如“feat: 实现用户JWT登录认证”、“fix: 修复订单价格计算错误”。这能让你的项目日志清晰也体现了工程素养。端口冲突问题Spring Boot默认端口是8080如果被占用会在application.yml中修改server.port。前端Vue CLI开发服务器默认是8080生产构建后由Nginx等服务器托管注意区分开发和生产环境的API请求地址可通过环境变量配置。静态资源路径404Vue项目执行npm run build后生成dist文件夹。如果直接双击index.html打开页面会是空白因为文件引用路径不对。必须使用HTTP服务器如Nginx、或Spring Boot的静态资源映射来部署这个dist文件夹。数据库初始化在另一台电脑或服务器上运行项目时数据库是空的。准备一个schema.sql建表语句和data.sql初始数据如管理员账号、默认景点放在resources目录下。在application.yml中配置spring.sql.init.modealwaysSpring Boot启动时会自动执行这些脚本。写在最后至此一个具备高可用雏形前后端分离、模块清晰和可扩展基础API设计、安全加固的旅游网站核心架构就搭建起来了。完成基础功能后你可以思考如何让它“更上一层楼”扩展搜索功能现在的景点查询可能只是简单的按名字模糊匹配。可以尝试集成Elasticsearch实现按地区、价格范围、标签等多维度的全文检索响应速度更快。引入缓存机制景点信息、热门推荐等不常变化的数据可以存入Redis。第一次查询从数据库读并放入Redis后续请求直接从Redis读取极大减轻数据库压力提升并发能力。毕业设计不仅是任务的完成更是一次系统的工程实践。希望这份笔记能为你提供一个清晰的路线图。最好的学习方式就是动手现在就打开IDE创建一个新的Spring Boot项目把第一个/hello接口跑起来吧每一步的实践都会让你对这套架构有更深的理解。祝你答辩顺利收获满满