做毕业设计选“旅游管理系统”这个题目的同学十个里面能有三到四个。为什么因为它业务边界清晰、模块容易划分、前后台分明既有CRUD又有业务逻辑订单、支付状态、线路规划工作量可控关键是演示效果好。尤其是基于Spring家族这套技术栈来做无论是找参考资料、排错修复还是答辩讲思路网上都能找到完整的链路。这篇文章我把整个项目的完整拆解过程写清楚从为什么选SpringSpringMVCMyBatis这套经典组合到数据库表怎么设计再到核心模块的代码逻辑、踩坑实录一条龙讲透。无论是准备开题、正在写代码还是到答辩前冲刺阶段都能从中直接抄作业。1. 内容整体设计与思路拆解1.1 为什么是Spring MVC MyBatis而不是Spring Boot现在很多教程上来就讲Spring Boot但毕业设计这个场景我仍推荐用Spring MVC MyBatis这套组合前提是你想“学东西”而不是“纯交差”。原因有三。第一毕业设计答辩时老师最常问的一句就是“你这个项目里Spring用在哪里”。Spring Boot的自动配置把这个过程藏起来了很多学生答不上来如果用Spring MVC你能清清楚楚地讲出DispatcherServlet怎么拦截请求、HandlerMapping怎么找到Controller、视图解析器怎么拼JSP页面。第二Spring的事务管理在传统XML配置里是看得见摸得着的aop:pointcut配在Service层的哪个方法上事务就生效在哪个方法上这个概念答出来非常加分。第三多数学校的软硬件环境还停留在JDK 1.8 Tomcat 8 MySQL 5.7的组合Spring Boot 3.0以上需要JDK 17反而容易出现环境兼容问题。这套系统的技术选型很简单JDK 1.8稳定市面资料最多Maven 3.6.x统一管理Jar包依赖Spring 5.x SpringMVC 5.x MyBatis 3.5.xMySQL 5.7 Navicat可视化工具Tomcat 8.5部署时直接用war包为什么用Maven毕业设计项目通常不小光Spring相关Jar包就几十个手动导lib目录容易漏配、版本冲突Maven能把这些依赖关系自动解决掉。配置一个pom.xml里面把spring-webmvc、spring-jdbc、mybatis、mybatis-spring、mysql-connector-java、jackson-databind、jstl这几组依赖配上基本就够了。1.2 需求拆解用户要什么系统给什么旅游管理系统的用户角色很简单两类游客/注册用户、管理员。但业务上却有两条线一条是用户端的预订浏览一条是管理端的数据维护。用户端的核心需求是注册登录游客可以注册成为会员登录后才能进入预订流程景点线路浏览主页展示热门线路点击进入详情页查看行程安排、价格、天数、景点介绍酒店查询按城市搜索酒店查看房型和价格订单操作选择线路、填写出行人数和日期生成订单订单有“待支付、已支付、已取消、已完成”几种状态个人中心查看我的订单、修改个人信息、发表评价留言管理端的核心需求是管理员登录账号密码由系统内置或通过后台创建线路管理对旅游线路做增删改查设置价格、库存、封面图酒店管理维护酒店信息、房型、价格区间订单管理查看所有用户的订单处理状态流转比如确认订单、取消异常订单留言管理审核用户评价删除不当言论这中间最容易忽略的是“库存”这个概念。很多学生做旅游管理系统只做了CRUD订单能生成但线路的“可报名人数”不会变。这其实是一个很大的商业逻辑漏洞。真实业务中每条线路有团期和名额用户下单成功后要扣减名额订单取消时要释放名额这个逻辑必须在Service层用事务保证原子性。1.3 模块划分与工程结构组织整套系统的Deme结构我推荐按三层架构来组织Controller层、Service层、Dao层也就是Mapper层配合一个domain实体包和一个common工具包。典型目录结构是这样src/main/java ├── com.travel.controller │ ├── UserController.java │ ├── AdminController.java │ ├── RouteController.java │ ├── HotelController.java │ └── OrderController.java ├── com.travel.service │ ├── UserService.java │ ├── RouteService.java │ ├── OrderService.java │ └── impl ├── com.travel.dao │ ├── UserMapper.java │ ├── RouteMapper.java │ ├── OrderMapper.java │ └── ... ├── com.travel.domain │ ├── User.java │ ├── Route.java │ ├── Hotel.java │ └── Order.java ├── com.travel.common │ ├── PageBean.java │ └── Result.java └── com.travel.interceptor └── LoginInterceptor.java src/main/resources ├── jdbc.properties ├── spring-context.xml ├── spring-mvc.xml ├── mybatis-config.xml └── mapper ├── UserMapper.xml ├── RouteMapper.xml └── OrderMapper.xml src/main/webapp ├── WEB-INF │ ├── web.xml │ └── views │ ├── index.jsp │ ├── route_detail.jsp │ ├── login.jsp │ └── admin │ ├── route_list.jsp │ └── order_list.jsp └── static ├── css ├── js └── images这里有个设计细节值得注意Mapper.xml文件放在resources/mapper目录下而不是和Java类放在一起。Maven默认只编译src/main/java下的java文件资源文件要放在resources目录才会被正确加载。如果初学者把UserMapper.xml和UserMapper.java放在同一个包下运行时会报“Invalid bound statement (not found)”这个经典错误。2. 核心功能模块设计与实现要点2.1 数据库表结构设计关系是系统的骨架旅游管理系统的核心是订单订单关联用户和线路这就是典型的三张主表加若干字典表。我在设计时一共建了6张表不多不少刚好覆盖所有需求CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 用户ID, username VARCHAR(50) UNIQUE NOT NULL COMMENT 用户名, password VARCHAR(100) NOT NULL COMMENT 密码, real_name VARCHAR(50) COMMENT 真实姓名, phone VARCHAR(20) COMMENT 手机号, email VARCHAR(100) COMMENT 邮箱, role VARCHAR(10) DEFAULT user COMMENT 角色user/admin, created_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE t_route ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 线路ID, name VARCHAR(100) NOT NULL COMMENT 线路名称, destination VARCHAR(100) COMMENT 目的地, days INT COMMENT 行程天数, price DECIMAL(10,2) COMMENT 价格, quota INT COMMENT 剩余名额, description TEXT COMMENT 行程描述, cover_url VARCHAR(255) COMMENT 封面图路径, status INT DEFAULT 1 COMMENT 状态1上架 0下架 ); CREATE TABLE t_hotel ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) COMMENT 酒店名称, city VARCHAR(50) COMMENT 所在城市, star_level INT COMMENT 星级, room_type VARCHAR(50) COMMENT 房型, price DECIMAL(10,2) COMMENT 每晚价格, address VARCHAR(200) COMMENT 地址 ); CREATE TABLE t_order ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(50) UNIQUE COMMENT 订单号, user_id INT COMMENT 下单用户ID, route_id INT COMMENT 线路ID, people_count INT COMMENT 出行人数, total_price DECIMAL(10,2) COMMENT 总金额, status INT DEFAULT 0 COMMENT 0待支付 1已支付 2已取消 3已完成, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, pay_time DATETIME, CONSTRAINT fk_order_user FOREIGN KEY(user_id) REFERENCES t_user(id), CONSTRAINT fk_order_route FOREIGN KEY(route_id) REFERENCES t_route(id) ); CREATE TABLE t_comment ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT COMMENT 评价用户, route_id INT COMMENT 对应线路, content VARCHAR(500) COMMENT 评价内容, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE t_favorite ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT COMMENT 用户ID, route_id INT COMMENT 线路ID, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );设计时要特别注意几个点第一金额字段一律用DECIMAL别用FLOAT。原因很简单FLOAT是近似值比如99.99存进去可能是99.989999999做加法时误差会累积订单总金额算错哪怕一毛钱答辩时都会被老师拿出来问。第二订单号不要用自增ID直接展示给用户要单独生成一个业务订单号。做法很多我一般用时间戳加随机数20250109103012 4位随机数字。这样即使两个用户同时下单订单号冲突的概率也极低。需要给t_order表的order_no字段加唯一索引。第三外键要不要加我的建议是逻辑外键足够。真正的数据库FOREIGN KEY约束在表数据量上来之后会有锁竞争问题毕业设计的数据量根本到不了那个级别但加上FK可以让数据库层面的关系更直观答辩时也更好讲。所以t_order上我保留了外键但实际代码中查询全部靠Mapper里的SQL关联不走JPA那种级联操作。2.2 用户登录注册与拦截器权限控制登录功能是几乎所有管理系统的门面这里用SpringMVC的HandlerInterceptor做登录拦截再合适不过。核心思路是用户登录成功后把user对象放到session中。定义一个LoginInterceptor在preHandle方法里判断session中是否存在user对象不存在就跳转到登录页并带上提示信息。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(loginUser); if (user null) { // 没有登录跳转到登录页 response.sendRedirect(request.getContextPath() /user/toLogin); return false; } // 判断访问的是否是管理员页面是的话还要校验角色 String uri request.getRequestURI(); if (uri.contains(/admin/) !admin.equals(user.getRole())) { response.setStatus(HttpServletResponse.SC_FORBIDDEN); return false; } return true; } }在spring-mvc.xml里配置拦截器的规则mvc:interceptors mvc:interceptor mvc:mapping path/** / mvc:exclude-mapping path/user/toLogin / mvc:exclude-mapping path/user/login / mvc:exclude-mapping path/route/list / mvc:exclude-mapping path/route/detail / mvc:exclude-mapping path/static/** / mvc:interceptor bean classcom.travel.interceptor.LoginInterceptor / /mvc:interceptor /mvc:interceptor /mvc:interceptors注意看exclude-mapping列表登录页、登录请求、线路列表和详情这些是游客也可以看的所以要排除拦截。静态资源css、js、images也要排除否则页面样式全丢。这里踩坑踩得最多的是路径问题mapping路径是“/”但是静态资源如果放在了webapp/static目录下访问时URL是/static/css/style.css如果对static没排除就会被拦截器跳去登录页。为什么要单独校验admin角色因为一个系统里普通用户和管理员用同一套登录接口登录成功后角色可能不同。管理端的页面和操作要求必须是管理员如果不能做角色层级判断任何登录用户都能看到管理菜单那权限管理就形同虚设了。当然也可以用Spring Security来做但毕业设计里手写拦截器比引入框架更能体现对权限的理解答辩老师也更认可。2.3 订单核心流程事务、状态与库存扣减订单模块是整个系统的核心也是答辩时最可能被深入盘问的部分。设计时一定要把流程理明白用户选中线路→进入订单确认页→填写人数和出发日期→生成订单状态为待支付→扣减线路库存→用户“模拟支付”→状态改为已支付。这里面有两个事务边界要讲清楚第一个边界是“创建订单时要同时扣减库存”。如果用两次独立的数据库操作A操作扣库存成功、B操作插入订单失败就会变成用户没下单但库存少了这就是典型的并发不一致问题。解决方法是把这两个操作放在同一个事务里用Spring的Transactional注解。Transactional(rollbackFor Exception.class) public void createOrder(Integer userId, Integer routeId, Integer peopleCount) { // 1.查询线路信息校验库存是否充足 Route route routeMapper.findById(routeId); if (route.getQuota() peopleCount) { throw new BusinessException(剩余名额不足); } // 2.扣减库存 routeMapper.decreaseQuota(routeId, peopleCount); // 3.计算总价生成订单 Order order new Order(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setRouteId(routeId); order.setPeopleCount(peopleCount); BigDecimal total route.getPrice().multiply(new BigDecimal(peopleCount)); order.setTotalPrice(total); order.setStatus(0); orderMapper.insert(order); }注意rollbackFor Exception.class这个细节。默认情况下Spring的事务只对RuntimeException回滚如果业务层抛出的是CheckedException比如Exception的直接子类事务不会回滚。加上rollbackForException.class表示无论啥异常数据都要回到操作前的状态。这个点我在答辩时被老师追问过答上来之后分明显高了一截。第二个边界是“支付成功后状态变更”。很多学生直接在Controller里写update语句把status从0改成1这种做法在演示时没问题但经不起追问。订单状态流转应该是待支付→已支付→已完成待支付→已取消已支付→已完成。每一个状态变更都应该有对应的校验逻辑比如不能把已取消的订单改成已完成。虽然这只是一个状态校验但体现的是业务闭环思维。为了让代码言简意赅订单状态我可以直接用枚举常量类public class OrderStatus { public static final int PENDING_PAYMENT 0; public static final int PAID 1; public static final int CANCELLED 2; public static final int COMPLETED 3; }在“模拟支付”里直接update status这在实际项目中会引出一个经典并发问题用户A和用户B同时支付同一个订单两个请求都读到status0都执行update……但由于订单是单用户创建的这个问题在毕业设计中基本不会出现。不过既然想到了还是要加一个乐观锁UPDATE t_order SET status 1 WHERE id ? AND status 0。这样即使并发执行也只有一个请求能真正更新成功。把这个SQL写进Mapper文件里讲解的时候说一句“用乐观锁防止状态被重复修改”给人的感觉就完全不一样了。2.4 分页查询与搜索功能的实现旅游系统里线路列表肯定要有分页否则几十条线路一次性全展示页面又慢又晃。SpringMVC MyBatis的分页我推荐手写一个PageBean而不是引入PageHelper插件。原因很简单PageHelper是通过拦截器在SQL语句后面拼LIMIT的原理对初学者来说很黑盒手写分页只要理解两个参数当前页码、每页条数和一个公式就行。PageBean代码其实就三个字段加一个构造方法public class PageBeanT { private int currentPage; // 当前页 private int pageSize; // 每页条数 private int totalCount; // 总记录数 private int totalPages; // 总页数 private ListT data; // 当前页数据 public PageBean(int currentPage, int pageSize, int totalCount, ListT data) { this.currentPage currentPage; this.pageSize pageSize; this.totalCount totalCount; this.data data; this.totalPages (int) Math.ceil((double) totalCount / pageSize); } }Controller里接收两个参数currentPage和pageSizepageSize给个默认值8就行。调用Mapper的count方法获取总条数再调list方法获取当前页的数据。注意MySQL的LIMIT语法偏移量要用公式算好// Mapper接口 int countRoutes(RouteQuery query); ListRoute findPage(Param(offset) int offset, Param(pageSize) int pageSize, Param(keyword) String keyword);select idfindPage resultTypecom.travel.domain.Route SELECT * FROM t_route where if testkeyword ! null and keyword ! AND name LIKE CONCAT(%, #{keyword}, %) /if /where ORDER BY id DESC LIMIT #{offset}, #{pageSize} /select搜索功能就一个技巧模糊查询用LIKE CONCAT(%, #{keyword}, %)而不是直接在Java代码里拼字符串传进来。前者能让MyBatis正确预处理参数you去掉SQL注入的风险。虽然不能在正文里漫谈安全细则但这个是每个开发者都该有的基本意识。分页查询做到位了前端JSP页面再配一个简单的分页条用EL表达式和JSTL标签循环页号。当前页高亮上一页下一页有链接URL上带上keyword参数保证翻页时搜索条件不丢这是很关键的细节。3. 关键配置文件与核心代码现场3.1 pom.xml依赖版本怎么选依赖版本这个问题可以说是毕业设计项目最折磨人的环节。版本不对轻则启动失败重则各种“不支持”的诡异报错。我给出一组经过大量项目验证的稳定组合properties spring.version5.3.39/spring.version mybatis.version3.5.16/mybatis.version jackson.version2.17.2/jackson.version /properties dependencies !-- Spring核心 -- dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version${spring.version}/version /dependency !-- MyBatis -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.1.2/version /dependency !-- MySQL驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency !-- Servlet和JSP相关 -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency !-- JSON转换 -- dependency groupIdcom.fasterxml.jackson.core/groupId artifactIdjackson-databind/artifactId version${jackson.version}/version /dependency /dependencies这里有一个容易掉进去的坑mysql-connector-java 8.x版本的Class.forName驱动名是“com.mysql.cj.jdbc.Driver”不是老教程里写的“com.mysql.jdbc.Driver”。如果照抄老教程启动时直接ClassNotFound。还有连接MySQL 8.0及以上版本JDBC URL要指定时区参数否则会报“The server time zone value”错误jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/travel_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password123456很多学生用MySQL 8.0但照着MySQL 5.5的配置写启动就报错又查不到原因。其实就把url里的serverTimezone参数加上就行。3.2 Spring和SpringMVC配置文件的分工Spring框架的配置文件可以拆成多个也可以写在一个applicationContext.xml里。我习惯拆成两份spring-context.xml管Service层和Dao层spring-mvc.xml管Controller层、视图解析器和静态资源。这样分工的好处是结构清晰讲的时候也好说“Spring管业务SpringMVC管Web层”。spring-context.xml里核心配置有数据源、SqlSessionFactory、Mapper扫描、Service扫描和事务管理!-- 读取jdbc.properties -- context:property-placeholder locationclasspath:jdbc.properties / !-- 数据源 -- bean iddataSource classorg.springframework.jdbc.datasource.DriverManagerDataSource property namedriverClassName value${jdbc.driver} / property nameurl value${jdbc.url} / property nameusername value${jdbc.username} / property namepassword value${jdbc.password} / /bean !-- SqlSessionFactory -- bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource / property nameconfigLocation valueclasspath:mybatis-config.xml / property namemapperLocations valueclasspath:mapper/*.xml / /bean !-- Mapper接口扫描 -- bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.travel.dao / /bean !-- 事务管理器 -- bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource / /bean aop:config aop:pointcut idtxPointcut expressionexecution(* com.travel.service.impl.*.*(..)) / aop:advisor advice-reftxAdvice pointcut-reftxPointcut / /aop:config配置事务管理器时我特意用了AOP方式。很多人喜欢直接在每个方法上加Transactional注解但用AOP声明事务的好处是一条规则管住所有Service方法不需要在业务代码里打补丁式地加注解。在aop:config里pointcut表达式“execution(* com.travel.service.impl..(..))”表示拦截impl包下所有类的所有方法。然后还可以配置tx:method规则比如查询方法用read-only事务增删改方法用默认事务。spring-mvc.xml的核心是开启注解驱动、配置视图解析器和组件扫描!-- 只扫描Controller层 -- context:component-scan base-packagecom.travel.controller / !-- 开启MVC注解驱动 -- mvc:annotation-driven / !-- 静态资源放行 -- mvc:resources location/static/ mapping/static/** / !-- 视图解析器 -- bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views/ / property namesuffix value.jsp / /bean注意组件扫描的base-package要精确到controller包如果把“com.travel”整个扫描进来ApplicationContext容器里会出现两套Service对象一套由spring-context.xml扫描一套由spring-mvc.xml扫描事务配置就有可能失效这是很多事务不生效问题的根源之一。3.3 web.xml部署描述符的配置web.xml是整个Web应用的入口JavaWeb毕业设计项目中它是必考项。要配置ContextLoaderListener加载spring-context.xml、配置DispatcherServlet加载spring-mvc.xml还有字符编码过滤器。web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd version4.0 !-- 加载Spring根容器 -- listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-context.xml/param-value /context-param !-- 字符编码过滤器 -- filter filter-namecharacterEncodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param init-param param-nameforceEncoding/param-name param-valuetrue/param-value /init-param /filter filter-mapping filter-namecharacterEncodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping !-- 前端控制器 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping /web-app这个配置里有几个值得细说的知识点过滤器为什么配forceEncoding为true默认情况下POST请求体里的编码会被request.setCharacterEncoding(UTF-8)处理但URL参数和响应头不一定。forceEncodingtrue表示强制对请求和响应都生效防止JSP页面乱码。load-on-startup设为1表示Tomcat启动时就加载DispatcherServlet而不是等第一个请求来了才加载。Server启动时如果spring容器有错会直接暴露出来方便调试。如果登录拦截器的路径配置了/那么DispatcherServlet的url-pattern必须也是/否则拦截器不会生效。因为Servlet容器对/*的匹配和/的匹配规则是不同的。3.4 Ajax异步请求与JSON返回这个系统里我用了两处Ajax一处是登录时校验用户名是否存在一处是酒店价格实时计算。用SpringMVC返回JSON数据很方便controller方法加上ResponseBody注解Spring容器里配置了Jackson依赖就能自动把对象转成JSON字符串返回前端。Controller RequestMapping(/user) public class UserController { Resource private UserService userService; ResponseBody RequestMapping(/checkUsername) public Result checkUsername(String username) { boolean exists userService.isUsernameExists(username); if (exists) { return Result.error(用户名已被注册); } return Result.success(该用户名可以使用); } }Result类是统一返回结果的包装类分三个字段code200成功500失败、msg提示信息、data业务数据。这样设计的好处是前端JavaScript统一判断code的值不用每次写不同的字段名。前端Ajax建议用jQuery封装好的$.ajax或$.post方法。在旅游管理系统的场景中我做了一个很实用的交互用户在订单详情页修改出行人数时实时计算总价格。这个不需要提交表单、不需要刷新页面体验比传统form提交好很多。4. 常见问题与排查技巧实录4.1 启动直接报404DispatcherServlet没配对Tomcat一启动访问首页就是404这个问题几乎每个做SSM的学生都会遇到。排查顺序是这样先看控制台有没有打印启动日志。如果Spring容器根本没启动往往是ContextLoaderListener没配或pom里缺Spring相关依赖。如果日志里出现“Unable to load class [com.travel.controller.UserController]”说明context:component-scan扫描包路径不对。如果是页面404但接口有响应则要看视图解析器。InternalResourceViewResolver的prefix和suffix路径拼起来之后要把Controller返回的逻辑视图名映射到真实的JSP文件路径。比如Controller返回index”拼接后就变成/WEB-INF/views/index.jsp。如果这个文件不存在就会404。很多同学把JSP页面直接放到webapp根目录下而prefix配置成了/WEB-INF/views/结果Controller配好了却找不到视图。注意JSP页面一定要放在WEB-INF目录下。一方面视图解析器要能找到另一方面WEB-INF下的文件不能通过浏览器直接URL访问这是一个安全边界——没有经过Controller层面逻辑校验的页面不应该被直接打开。4.2 Invalid bound statement (not found)Mapper没绑上这个报错在MyBatis项目里非常经典英文直译过来是“无效的绑定语句”大概意思是Mapper接口里的方法找不到对应的SQL语句。排查路径有三步第一步检查Mapper.xml文件是不是真的在resources/mapper目录下并且Mapper接口里方法的namespace是否和XML的namespace一致。namespace写错是最常见的原因。第二步检查Spring配置里SqlSessionFactoryBean的mapperLocations属性。如果没配Spring根本不知道去哪里加载XML文件。配置为classpath:mapper/*.xml就能自动扫描到resources下的文件。第三步检查MapperScannerConfigurer的basePackage是否指向了正确的dao包。如果包名写错Mapper接口就没被注册到Spring容器Autowired时还会报找不到Bean。还有一个隐蔽的坑Maven多模块项目里如果你把Mapper.xml放在src/main/java的某个包下没有放到resources目录Maven打包时默认不会把xml文件打进jar/war包里。即使本地开发调试时IDE能从编译目录找到文件部署到Tomcat时还是会报Invalid bound statement。把XML放到resources目录下是根治方案。4.3 JSP页面全部乱码字符编码三层不一致中文乱码是JavaWeb项目的高频问题旅游管理系统的线路名称、酒店地址全是中文一旦乱码整个页面就没法看。我排查乱码的经验是分三层看第一层数据库连接URL。URL加上了characterEncodingutf8这个负责数据库读写时的编码映射。不加这一条MySQL默认的latin1编码下中文乱码是必然的。第二层Servlet过滤器。web.xml里的CharacterEncodingFilter要配encodingUTF-8且forceEncodingtrue。forceEncoding不设的话只有POST请求体的解码用UTF-8对URL参数和响应内容不生效。第三层JSP文件本身的编码。JSP页面头部要写% page contentTypetext/html;charsetUTF-8 languagejava %同时文件保存的格式也要是UTF-8。IDEA右下角可以改文件编码如果是GBK存的文件页面头声明UTF-8也没用因为文件本身字节流的编码就不是UTF-8。MySQL建表时也要指定utf8字符集。所以我在建表语句里写了DEFAULT CHARSETutf8。整条链路都对了中文才能畅通无阻。4.4 服务器端口被占用Tomcat起不来写代码进入状态前一个项目残留的Tomcat进程没关干净再次启动就报端口被占用。我推荐直接用命令行查端口netstat -ano | findstr 8080查到占用8080端口的PID之后打开任务管理器把这个进程结束。如果是IDEA启动的Tomcat崩溃了但进程没退出还可以在IDEA的Run面板里点击左上角的“Stop”红色方块触发强制停止。这个问题不大但如果在答辩现场闹这么一出前一分钟还信心满满后一分钟手忙脚乱很影响状态。我的建议是把Tomcat默认端口改成8088减小和系统中其他项目的冲突概率Connector port8088 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /4.5 500错误排查异常堆栈才是第一线索每次遇到500很多同学不知道从哪里下手。我最想强调的习惯是先把IDEA控制台的日志往上翻找到“Caused by”这一行。这个Caused by才是异常的根源上面的那些Caused by只是表象。常见的几个Caused by以及对应解法NullPointerExceptionService层返回了nullController直接调了方法。多数是Mapper查询条件写错查不到数据。BadSqlGrammarExceptionSQL语句语法错误看看是不是字段名写错了或者表名和数据里的不一致。DataIntegrityViolationException数据完整性问题比如insert时某字段非空但没赋值外键关联的数据不存在。ClassNotFoundException: org.springframework.web.context.ContextLoaderListenerpom.xml里少了spring-web包或者依赖没下载全右侧Maven面板里刷新一下重新导入。排查500的思路我习惯用二分定位法先确定是Controller层之前挂了还是之后挂了。在Controller方法的第一行加上System.out.println(进入XXX方法)如果日志没打出来说明请求根本没到达Controller要么被拦截器拦截了要么视图解析异常如果日志打出来了再在Service方法出入口分别打日志逐层缩小范围。这个方法虽然土但比瞎猜效率高一倍。4.6 我的几个独家避坑技巧第一个技巧是开发期间不要开启“热部署”。很多同学喜欢用Jrebel或者Spring DevTools实现改代码自动重启Tomcat报错时页面还是上一次的状态排查起来心态极易爆炸。毕业设计本来代码量不大保存后手动点一下重启几秒钟的事不值得为热部署引入额外的不确定性。第二个技巧是经常把SQL复制到Navicat里跑一遍。MyBatis的XML里有一个很常见的坑手动拼接SQL时多了一个逗号、少了一个AND控制台报错后最快的方式就是把报错信息里的SQL片段注意是拼接完成的完整SQLMyBatis通常会打印在日志中复制到数据库工具里直接执行错误马上就能定位。等你直接执行成功了再对照着改XML文件。第三个技巧是导出数据库脚本。最后一个阶段交文档、交答辩演示环境时把数据库导成sql文件手写清库建库建表脚本比用Navicat的转储更“可疑”——老师可能会在答辩当天让你现场导入数据库如果用的是Navicat生成的迁移脚本别人没有对应版本的工具就打不开。我给的做法是DROP DATABASE IF EXISTS travel_db; CREATE DATABASE travel_db DEFAULT CHARACTER SET utf8; USE travel_db; -- 后面跟着完整CREATE TABLE和INSERT INTO初始化数据把这个脚本放到项目docs/sql目录下面一个完整的“初始化脚本初始化数据”包就齐了。老师现场要环境三分钟就能搭起来体验感和随意丢一个备份数据文件比起来完全不同。5. 论文与答辩注意事项5.1 LW文档论文怎么组织才不吃亏毕业设计的LW文档是答辩评分的重要依据但很多学生最后一周才开始写导致出错率飙升。我观察下来一份合格的论文至少要把这几部分写透第一章绪论研究背景与意义。这一章不要写空话要结合自己系统的具体场景写。旅游管理系统的痛点是什么信息分散、人工管理效率低、游客难以及时获取线路信息。把这些痛点对应到你做的功能模块上逻辑就立住了。第二章需求分析画用例图和流程图。这部分里用例要覆盖所有角色不只画一个“用户用例图”要把管理员单独的用例也画出来。数据流程图描述一下用户预订的完整流程从登录到支付再到行程结束后的评价。第三章系统设计包括总体架构图、功能模块图、数据库ER图和表结构说明。表结构说明部分把每张表的主要字段列出来备注好含义和约束。第四章系统实现按模块分小节写结合截图。每小节至少包含“核心代码片段页面截图功能说明”三件套。核心代码不要整段贴选一个关键方法比如创建订单的createOrder方法贴出来然后逐步解释。第五章系统测试测试用例表是必须的里面至少包括10条用例覆盖登录测试、线路模糊查询测试、创建订单测试、库存不足测试、未登录拦截测试等。每条用例写清楚测试输入、预期结果、实际结果和结论。论文最容易翻车的地方是“图和代码不一致”。比如架构图画了6个模块正文只写了4个数据库ER图里画的字段建表语句里根本没有。写论文时先列出一张“图表与代码对照清单”每画一张图就标记它对应正文的哪个模块和哪段代码写完后再手动检查一遍能避免大部分低级失误。5.2 答辩演示脚本一分钟抓住老师注意力答辩现场一般只有5到10分钟的展示时间。很多学生演示时从登录页开始一步步点点点结果时间耗光了还没展示到核心的订单模块老师想问的也问不出来。我建议演示按这个顺序来第一步讲系统功能架构用一张功能模块图快速交代系统有哪些模块不需要逐一演示。第二步演示用户端的一条核心业务流注册新用户→搜索一条线路→查看详情→下订单→模拟支付→在个人中心看到订单。这展示的是业务闭环老师最关心的是这个。第三步切到管理员端演示线路管理的增删改查再演示如何把一条线路下架。如果时间充裕再演示订单管理里审核订单、取消订单的操作。第四步回答问题环节。这一环节最常被问的几个问题我必须提前列出来为什么选择Spring MVC/MyBatis这个组合答因为Spring MVC负责Web层的请求分发和视图控制MyBatis将SQL与Java代码分离便于维护和优化两者结合清晰实现了分层解耦。系统中的事务你是怎么处理的答在创建订单和扣减库存这类需要保证原子性的操作上用了Spring声明式事务基于AOP切面配置在Service层出现任何异常都会整体回滚。用户密码在数据库里怎么存的答明文存储是不可取的实际开发中需要MD5加盐或BCrypt加密。如果当时写的是明文坦诚地说“演示环境里为了调试方便用了简单处理实际项目必须加密”然后说出加密方案反而加分。你项目的亮点是什么答订单和库存的事务一致性处理、登录拦截器权限控制、乐观锁防止订单状态重复变更。这些问题都得提前准备尤其是“你的项目有哪些不足”这种终结问题。诚实回答存在哪些改进空间并补一句“针对这个问题我的优化思路是……”这样的答案比嘴硬说“没有不足”好得多。5.3 打包部署演示环境的经验毕业设计最后是要跑起来给老师看的配置环境时常遇到两种场景一种是在自己电脑上演示一种是到学校机房或老师电脑上演示。不管哪种提前把部署环境准备好都能省下大量时间。我通常的做法是打包成war包部署到Tomcat的webapps目录下。IDEA里操作是Project Structure → Artifacts → 添加Web Application Exploded然后Build → Build Artifacts → 选择war包构建。构建完成后war包会在target目录下把war包复制到Tomcat的webapps目录启动Tomcat后就自动解压访问路径是http://localhost:8080/travel_war_exploded/注意war包的名称就是URL的上下文路径。如果你想让访问路径不带项目名前缀就把war包改名为ROOT.war并删除Tomcat原有webapps/ROOT目录中的内容。这样访问就是http://localhost:8080/数据库方面最稳妥的方法是生成一个SQL初始化脚本把建库、建表、插入管理员账号比如用户名admin密码123456都写进去。到现场只需要打开Navicat或者命令行执行一次脚本系统就能跑起来。6. 系统可扩展方向的思考旅游管理系统这个题目虽然“常见”但它的业务延展性其实相当好。如果做完基本功能还有余力或者在答辩时被问到“项目以后怎么扩展”这几条思路都可以展开说。一是引入Spring Boot重构。把SpringSpringMVCMyBatis的XML配置全部替换成Application注解和自动配置系统架构不变但代码更简洁部署方式从war包变成jar包内嵌Tomcat这是一个完整的架构演进过程。二是增加ECharts数据可视化大屏。管理员后台加一个“旅游数据概览”展示本月订单量、热门线路排行、各城市线路分布、收益趋势图。ECharts是纯前端的图表库后端只需要提供一个JSON接口比如按城市统计线路数量的接口ResponseBody RequestMapping(/admin/route/cityCount) public Result cityCount() { ListMapString, Object list routeMapper.countByCity(); return Result.success(list); }前端用ECharts的bar或pie图渲染不仅好看而且制作简单效果拔群。三是引入Redis缓存热门线路。把首页高频访问的线路列表缓存到Redis里减少MySQL的查询压力。虽然毕业设计的数据量看不出性能差异但面试或答辩时讲出这个思路能体现对系统性能有优化意识。四是接入第三方支付模拟。真实的旅游平台必然要对接微信支付、支付宝支付但毕业设计当然不做真实对接。可以采用一个“模拟支付页面”弹出二维码用第三方库生成假二维码之类的实现。推进系统时保留好状态流转的业务设计对接时就只是换一个支付通道的实现。这些扩展方向能做到一两个项目的完整性、创新性和工作量都会上一个档次。如果时间充裕我建议至少把ECharts数据可视化做出来性价比最高。最后分享一点我自己做这类毕业设计项目的体会。真正能把一个旅游管理系统做得像样的往往不是一开始就厉害了而是愿意把基础功打扎实的人。Spring框架的依赖注入、面向切面、事务管理这些概念在学校课堂上听十遍都不如在项目里被坑一遍。我遇到过太多学生CRUD写得很流利但问一句“为什么这里要加注解”就答不上来了。这也说明做项目不能只想着“跑起来”而是要把每一步都问为什么。就以代码里的一个细小配置为例为什么创建订单要放在事务里而查询订单不开事务为什么删除线路之前要先检查有没有关联的未完成订单为什么用户密码不能明文存储这些“为什么”串联起来才是毕业设计真正要训练的核心能力也是答辩现场底气所在。在做这个系统的过程中我踩过无数坑从依赖冲突到数据库乱码从分页公式算错到跨域请求问题几乎每一步都在跌跟头。但每解决一个问题对这套技术栈的理解就深一层。这篇分享里的经验就是这些跟头换来的。希望读到这里的人能少走几步弯路把时间省下来专注在最值得琢磨的业务逻辑和架构思路上。