简介这份资源是面向Java初学者与进阶开发者的Spring Boot旅游信息管理系统完整项目包包含可运行源码与数据库SQL脚本适合作为课程设计、毕业设计或框架学习的实战案例。压缩包共1384个文件约40.95MB以jpg、html、gif、png、js等前端资源为主另有88个java源文件、88个class文件、117个xml配置及1个sql脚本覆盖页面展示、业务逻辑与数据库结构。系统采用MVC设计模式后端涉及Spring Security安全控制前端集成主流框架内容预览可见酒店、景点、路线、保险、车辆等多个控制器功能模块划分清晰。已有53人学习下载。读者可借此理解Spring Boot项目如何组织代码与配置文件掌握数据库建表与初始化流程并参考报告文档完成需求分析与部署兼具实用价值与学习参考意义。1. 一个 SpringBoot 旅游信息管理系统的真实打开方式如果你正在做 Java 课程设计或者毕业设计大概率会遇到这个场景选题定了“旅游信息管理系统”需求文档写完了数据库表也画了 ER 图但真正动手写代码时发现——从零搭一个能跑通前后端、带权限、带增删改查、还能连数据库的项目工作量远比想象中大。这份springboot旅游信息管理系统源码sql.zip就是冲着这个场景来的它把一套完整的旅游信息管理后端代码和对应的 SQL 建表脚本打包在一起解压后导入 IDE、执行 SQL、改一下数据库连接配置就能跑起来。它适合三类人一是课程设计时间紧、需要一份结构清晰可二次开发的底稿二是刚学完 SpringBoot 想找一个完整项目练手但不想在环境搭建上耗太久三是需要一份带数据库脚本的参考实现用来对照自己的表结构设计是否合理。技术栈是典型的 SpringBoot MyBatis 组合数据库用 MySQLSQL 脚本直接给了建表和初始数据省掉了自己一条条写 DDL 的功夫。下面我从项目结构、环境配置、SQL 导入、接口调试到常见翻车点按实际复现顺序拆一遍。2. 项目结构与技术栈拆解先看清骨架再动手2.1 目录层级与分层逻辑拿到压缩包解压后常见做法是先别急着导入 IDE用文件管理器把目录树扫一遍。一个标准的 SpringBoot 旅游信息管理系统源码部分通常长这样src/main/java/com/xxx/tourism/ ├── TourismApplication.java // 启动类 ├── controller/ // 接口层 │ ├── ScenicController.java │ ├── OrderController.java │ └── UserController.java ├── service/ // 业务层 │ ├── impl/ │ └── ScenicService.java ├── mapper/ // 持久层接口 │ └── ScenicMapper.java ├── entity/ // 实体类 │ └── Scenic.java └── config/ // 配置类 └── WebConfig.java src/main/resources/ ├── application.yml // 主配置 ├── mapper/ // MyBatis XML │ └── ScenicMapper.xml └── static/ // 前端静态资源如果有这个分层是 SpringBoot 项目最通用的 MVC 三层结构controller 接请求、service 写业务、mapper 管数据库。旅游信息管理系统的业务实体一般围绕景点scenic、线路route、订单order、用户user、公告notice这几张核心表展开。你拿到源码后第一件事是对照 SQL 脚本里的表名确认 entity 包下的类是否一一对应——有些打包版本会多出几张用不上的表或者 entity 字段和 SQL 列名有细微出入这个后面避坑章节会细说。2.2 依赖版本与 SpringBoot 版本选择打开pom.xml重点看三块SpringBoot 父版本、MyBatis 起步依赖、MySQL 驱动版本。常见配置如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.6/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.0/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.31/version /dependency /dependencies这里有个血泪经验如果你的 JDK 是 17 或更高SpringBoot 2.7.x 虽然能跑但部分反射相关代码会报警告如果 JDK 是 1.8那 2.7.6 是稳妥选择。热词里常出现“springboot版本太高”的抱怨根源多半是 JDK 版本和 SpringBoot 版本没对齐。我一般会先java -version确认 JDK再决定要不要把 parent 版本降到 2.3.x 或升到 3.x。注意 SpringBoot 3.x 要求 JDK 17 起步且javax.*包全部换成了jakarta.*老代码直接升会编译不过。MySQL 驱动这块8.0 以上用com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver连接串里还要注意时区参数serverTimezoneAsia/Shanghai否则启动时报时区错误是高频翻车点。2.3 配置文件关键项逐条说明application.yml是启动成败的关键逐项过一遍server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/tourism_db?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.tourism.entity configuration: map-underscore-to-camel-case: truemapper-locations指向 XML 映射文件位置写错会导致启动时报Invalid bound statement。map-underscore-to-camel-case开启后数据库的scenic_name会自动映射到实体类的scenicName省掉大量 resultMap 配置。type-aliases-package让 XML 里可以直接写类名而不用全限定名。数据库名tourism_db要和 SQL 脚本里CREATE DATABASE或USE语句一致不一致就自己改配置或改脚本别硬扛。3. SQL 脚本导入与数据库初始化别小看这一步3.1 建库建表脚本的执行顺序SQL 脚本一般包含三部分建库语句、建表语句、初始数据 INSERT。常见做法是在 Navicat 或命令行里按顺序执行。命令行方式# 登录 MySQL mysql -u root -p # 执行脚本假设脚本名为 tourism.sql source /path/to/tourism.sql; # 验证 show databases; use tourism_db; show tables;如果你用 Navicat直接右键连接选“运行 SQL 文件”选中脚本执行即可。注意脚本里如果有DROP TABLE IF EXISTS重复执行不会报错但会清空已有数据第一次导入无所谓后续调试要小心。执行完用show tables;确认表数量。一个旅游信息管理系统通常有 6 到 10 张表少了说明脚本没跑完多了可能是包含了日志表或测试表。重点确认scenic、orders、user这三张核心表是否存在且有数据。3.2 表结构与实体类字段对照导入成功后用desc scenic;看列名和类型再打开 entity 包下的Scenic.java对照。常见的不一致有几种SQL 里是scenic_id实体类写的是idSQL 里price是decimal(10,2)实体类用了DoubleSQL 里create_time是datetime实体类用了String。这些在 MyBatis 自动映射时不会报错但查出来的值可能是 null 或者类型转换异常。我一般会写一条最简单的查询来验证映射是否正常// ScenicMapper.java Select(SELECT * FROM scenic LIMIT 1) Scenic selectOneForTest();启动项目后调这个接口如果返回的对象字段大部分为 null说明列名和属性名没对上要么改 SQL 别名要么在实体类上加Results手动映射。这一步花五分钟能省掉后面调业务接口时两小时的排查。3.3 初始数据与分页查询验证SQL 脚本里的初始数据一般够你跑通列表页。验证分页时常见做法是用 MyBatis-Plus 的分页插件或手写LIMIT。如果项目用的是原生 MyBatisXML 里通常这样写select idselectByPage resultTypeScenic SELECT * FROM scenic where if testname ! null and name ! AND scenic_name LIKE CONCAT(%, #{name}, %) /if /where LIMIT #{offset}, #{pageSize} /selectoffset是起始行pageSize是每页条数。调用时传offset (pageNum - 1) * pageSize。如果查出来总数不对先单独跑SELECT COUNT(*) FROM scenic确认数据量再检查LIMIT参数有没有传反。热词里“sql语句去重”也常出现在这里——如果景点表有重复名称列表页会出现重复项加GROUP BY scenic_name或DISTINCT能解决但要注意别把不同 id 的记录误合并。4. 接口调试与前后端联调从启动到跑通第一个请求4.1 启动类与常见启动报错启动类就是标准的SpringApplication.run但启动失败的原因五花八门。按报错信息分几类第一类端口占用。报Port 8080 was already in use解决方式是改server.port或者杀掉占用进程。Windows 下netstat -ano | findstr 8080找到 PID再taskkill /PID xxx /F。第二类数据库连接失败。报Communications link failure或Access denied for user检查 MySQL 服务是否启动、用户名密码是否正确、useSSL参数是否加了。MySQL 8.0 默认要求 SSL不加useSSLfalse会连不上。第三类Mapper 绑定失败。报Invalid bound statement (not found)九成是mapper-locations路径写错或者 XML 文件的 namespace 和 Mapper 接口全限定名不一致。打开 XML 第一行mapper namespacecom.xxx.tourism.mapper.ScenicMapper和接口包名逐字对照。4.2 用 Postman 或 curl 验证 CRUD项目启动后先测一个最简单的 GET 接口。假设景点列表接口是/scenic/listcurl -X GET http://localhost:8080/scenic/list?pageNum1pageSize10 \ -H Content-Type: application/json如果返回 JSON 数组且字段完整说明 controller、service、mapper、数据库这条链路是通的。接着测 POST 新增curl -X POST http://localhost:8080/scenic/add \ -H Content-Type: application/json \ -d {scenicName:测试景点,price:99.00,address:测试地址}新增成功后用 GET 查一下是否真的写入了。如果 POST 返回成功但数据库没数据检查 service 层有没有加Transactional且方法内抛了异常被吞掉或者 MyBatis 的insert语句没写useGeneratedKeystrue导致主键没回填。4.3 跨域与静态资源访问如果项目带了前端页面Vue 打包后放进static目录常见问题是接口 404 或跨域。Vue 打包放进 SpringBoot 后路由要配history模式的话需要加一个 fallback controller 把非 API 请求转发到index.html。跨域则在 controller 上加CrossOrigin或在 config 里配WebMvcConfigurerConfiguration public class WebConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true); } }allowedOriginPatterns在 SpringBoot 2.4 以后替代了allowedOrigins用旧写法会报错。如果前端请求带 cookieallowCredentials(true)必须加且 origin 不能写*要用具体域名或 pattern。5. 避坑与排查那些让你怀疑人生的报错5.1 启动报时区错误现象启动时抛The server time zone value йʱ is unrecognized。 原因MySQL 服务器时区是系统默认JDBC 驱动无法识别中文时区名。 解决连接串加serverTimezoneAsia/Shanghai或者登录 MySQL 执行SET GLOBAL time_zone 8:00;。5.2 查询返回字段全为 null现象接口返回 200但 JSON 里字段都是 null。 原因数据库列名scenic_name和实体属性scenicName没开启驼峰映射或者 XML 里 resultType 写成了全限定名但别名没配。 解决application.yml里加map-underscore-to-camel-case: true或者 XML 里手写 resultMap 逐列映射。5.3 新增数据主键不回填现象insert 成功但返回的对象 id 为 null。 原因XML 的insert没加useGeneratedKeystrue keyPropertyid。 解决改成insert idinsert useGeneratedKeystrue keyPropertyid注意 keyProperty 要和实体类主键属性名一致。5.4 分页查询总数不对现象列表数据正确但分页组件显示总页数错误。 原因count 语句和 list 语句的 where 条件不一致或者 count 查的是全表。 解决把 where 条件抽成sql片段count 和 list 都引用同一个片段保证条件一致。5.5 打包后运行报找不到主类现象mvn package成功但java -jar报no main manifest attribute。 原因pom 里没配spring-boot-maven-plugin或者配了但没执行repackage。 解决在 build 节点加插件并绑定 repackage goal重新打包。6. 二次开发与进阶技巧让这套源码真正为你所用拿到一份能跑的源码只是起点真正让它变成你自己的东西得会改。第一个进阶方向是加权限控制。原始项目可能只有简单的登录校验你可以引入 Spring Security 或 Shiro把用户角色和菜单权限做成动态的。常见做法是加一张role表和user_role关联表登录时查角色接口上用注解拦截。第二个方向是慢 SQL 优化。旅游信息管理系统的景点查询如果数据量大LIKE %关键词%会全表扫描。我一般会先开 MyBatis 的 SQL 日志把logging.level.com.xxx.tourism.mapperDEBUG打开看实际执行的 SQL 和执行时间。如果某条查询超过 500ms考虑给scenic_name加索引或者把模糊查询改成全文索引。热词里“慢 SQL 优化”在这个场景下非常实用因为景点表往往是数据量最大的一张。第三个方向是接口文档自动化。手写接口文档容易和代码脱节引入 Swagger 或 Knife4j 后注解写在 controller 上文档自动生成。加依赖dependency groupIdcom.github.xiaoymin/groupId artifactIdknife4j-spring-boot-starter/artifactId version3.0.3/version /dependency然后在 config 里加EnableKnife4j和 Docket 配置启动后访问/doc.html就能看到所有接口。注意 SpringBoot 2.7 和 Knife4j 3.0.3 搭配时需要额外加spring.mvc.pathmatch.matching-strategyant_path_matcher否则启动报错。最后一个技巧是数据库脚本的版本管理。别每次改表都手动执行 SQL用 Flyway 或 Liquibase 把每次变更写成版本化脚本项目启动时自动执行。这样换一台机器部署时不用再翻聊天记录找“上次那个 alter 语句”。我自己的习惯是每次改完表结构立刻把变更写成V2__add_column.sql放进resources/db/migration下次启动自动生效。从那以后我每次拿到新项目都强制先跑一遍show tables和desc确认表结构再动代码。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/7 16:26:31 · 阅读 1.2k SpringBoot旅游信息管理系统源码与SQL脚本实战指南
简介这份资源是面向Java初学者与进阶开发者的Spring Boot旅游信息管理系统完整项目包包含可运行源码与数据库SQL脚本适合作为课程设计、毕业设计或框架学习的实战案例。压缩包共1384个文件约40.95MB以jpg、html、gif、png、js等前端资源为主另有88个java源文件、88个class文件、117个xml配置及1个sql脚本覆盖页面展示、业务逻辑与数据库结构。系统采用MVC设计模式后端涉及Spring Security安全控制前端集成主流框架内容预览可见酒店、景点、路线、保险、车辆等多个控制器功能模块划分清晰。已有53人学习下载。读者可借此理解Spring Boot项目如何组织代码与配置文件掌握数据库建表与初始化流程并参考报告文档完成需求分析与部署兼具实用价值与学习参考意义。1. 一个 SpringBoot 旅游信息管理系统的真实打开方式如果你正在做 Java 课程设计或者毕业设计大概率会遇到这个场景选题定了“旅游信息管理系统”需求文档写完了数据库表也画了 ER 图但真正动手写代码时发现——从零搭一个能跑通前后端、带权限、带增删改查、还能连数据库的项目工作量远比想象中大。这份springboot旅游信息管理系统源码sql.zip就是冲着这个场景来的它把一套完整的旅游信息管理后端代码和对应的 SQL 建表脚本打包在一起解压后导入 IDE、执行 SQL、改一下数据库连接配置就能跑起来。它适合三类人一是课程设计时间紧、需要一份结构清晰可二次开发的底稿二是刚学完 SpringBoot 想找一个完整项目练手但不想在环境搭建上耗太久三是需要一份带数据库脚本的参考实现用来对照自己的表结构设计是否合理。技术栈是典型的 SpringBoot MyBatis 组合数据库用 MySQLSQL 脚本直接给了建表和初始数据省掉了自己一条条写 DDL 的功夫。下面我从项目结构、环境配置、SQL 导入、接口调试到常见翻车点按实际复现顺序拆一遍。2. 项目结构与技术栈拆解先看清骨架再动手2.1 目录层级与分层逻辑拿到压缩包解压后常见做法是先别急着导入 IDE用文件管理器把目录树扫一遍。一个标准的 SpringBoot 旅游信息管理系统源码部分通常长这样src/main/java/com/xxx/tourism/ ├── TourismApplication.java // 启动类 ├── controller/ // 接口层 │ ├── ScenicController.java │ ├── OrderController.java │ └── UserController.java ├── service/ // 业务层 │ ├── impl/ │ └── ScenicService.java ├── mapper/ // 持久层接口 │ └── ScenicMapper.java ├── entity/ // 实体类 │ └── Scenic.java └── config/ // 配置类 └── WebConfig.java src/main/resources/ ├── application.yml // 主配置 ├── mapper/ // MyBatis XML │ └── ScenicMapper.xml └── static/ // 前端静态资源如果有这个分层是 SpringBoot 项目最通用的 MVC 三层结构controller 接请求、service 写业务、mapper 管数据库。旅游信息管理系统的业务实体一般围绕景点scenic、线路route、订单order、用户user、公告notice这几张核心表展开。你拿到源码后第一件事是对照 SQL 脚本里的表名确认 entity 包下的类是否一一对应——有些打包版本会多出几张用不上的表或者 entity 字段和 SQL 列名有细微出入这个后面避坑章节会细说。2.2 依赖版本与 SpringBoot 版本选择打开pom.xml重点看三块SpringBoot 父版本、MyBatis 起步依赖、MySQL 驱动版本。常见配置如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.6/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.0/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.31/version /dependency /dependencies这里有个血泪经验如果你的 JDK 是 17 或更高SpringBoot 2.7.x 虽然能跑但部分反射相关代码会报警告如果 JDK 是 1.8那 2.7.6 是稳妥选择。热词里常出现“springboot版本太高”的抱怨根源多半是 JDK 版本和 SpringBoot 版本没对齐。我一般会先java -version确认 JDK再决定要不要把 parent 版本降到 2.3.x 或升到 3.x。注意 SpringBoot 3.x 要求 JDK 17 起步且javax.*包全部换成了jakarta.*老代码直接升会编译不过。MySQL 驱动这块8.0 以上用com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver连接串里还要注意时区参数serverTimezoneAsia/Shanghai否则启动时报时区错误是高频翻车点。2.3 配置文件关键项逐条说明application.yml是启动成败的关键逐项过一遍server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/tourism_db?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 你的密码 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.xxx.tourism.entity configuration: map-underscore-to-camel-case: truemapper-locations指向 XML 映射文件位置写错会导致启动时报Invalid bound statement。map-underscore-to-camel-case开启后数据库的scenic_name会自动映射到实体类的scenicName省掉大量 resultMap 配置。type-aliases-package让 XML 里可以直接写类名而不用全限定名。数据库名tourism_db要和 SQL 脚本里CREATE DATABASE或USE语句一致不一致就自己改配置或改脚本别硬扛。3. SQL 脚本导入与数据库初始化别小看这一步3.1 建库建表脚本的执行顺序SQL 脚本一般包含三部分建库语句、建表语句、初始数据 INSERT。常见做法是在 Navicat 或命令行里按顺序执行。命令行方式# 登录 MySQL mysql -u root -p # 执行脚本假设脚本名为 tourism.sql source /path/to/tourism.sql; # 验证 show databases; use tourism_db; show tables;如果你用 Navicat直接右键连接选“运行 SQL 文件”选中脚本执行即可。注意脚本里如果有DROP TABLE IF EXISTS重复执行不会报错但会清空已有数据第一次导入无所谓后续调试要小心。执行完用show tables;确认表数量。一个旅游信息管理系统通常有 6 到 10 张表少了说明脚本没跑完多了可能是包含了日志表或测试表。重点确认scenic、orders、user这三张核心表是否存在且有数据。3.2 表结构与实体类字段对照导入成功后用desc scenic;看列名和类型再打开 entity 包下的Scenic.java对照。常见的不一致有几种SQL 里是scenic_id实体类写的是idSQL 里price是decimal(10,2)实体类用了DoubleSQL 里create_time是datetime实体类用了String。这些在 MyBatis 自动映射时不会报错但查出来的值可能是 null 或者类型转换异常。我一般会写一条最简单的查询来验证映射是否正常// ScenicMapper.java Select(SELECT * FROM scenic LIMIT 1) Scenic selectOneForTest();启动项目后调这个接口如果返回的对象字段大部分为 null说明列名和属性名没对上要么改 SQL 别名要么在实体类上加Results手动映射。这一步花五分钟能省掉后面调业务接口时两小时的排查。3.3 初始数据与分页查询验证SQL 脚本里的初始数据一般够你跑通列表页。验证分页时常见做法是用 MyBatis-Plus 的分页插件或手写LIMIT。如果项目用的是原生 MyBatisXML 里通常这样写select idselectByPage resultTypeScenic SELECT * FROM scenic where if testname ! null and name ! AND scenic_name LIKE CONCAT(%, #{name}, %) /if /where LIMIT #{offset}, #{pageSize} /selectoffset是起始行pageSize是每页条数。调用时传offset (pageNum - 1) * pageSize。如果查出来总数不对先单独跑SELECT COUNT(*) FROM scenic确认数据量再检查LIMIT参数有没有传反。热词里“sql语句去重”也常出现在这里——如果景点表有重复名称列表页会出现重复项加GROUP BY scenic_name或DISTINCT能解决但要注意别把不同 id 的记录误合并。4. 接口调试与前后端联调从启动到跑通第一个请求4.1 启动类与常见启动报错启动类就是标准的SpringApplication.run但启动失败的原因五花八门。按报错信息分几类第一类端口占用。报Port 8080 was already in use解决方式是改server.port或者杀掉占用进程。Windows 下netstat -ano | findstr 8080找到 PID再taskkill /PID xxx /F。第二类数据库连接失败。报Communications link failure或Access denied for user检查 MySQL 服务是否启动、用户名密码是否正确、useSSL参数是否加了。MySQL 8.0 默认要求 SSL不加useSSLfalse会连不上。第三类Mapper 绑定失败。报Invalid bound statement (not found)九成是mapper-locations路径写错或者 XML 文件的 namespace 和 Mapper 接口全限定名不一致。打开 XML 第一行mapper namespacecom.xxx.tourism.mapper.ScenicMapper和接口包名逐字对照。4.2 用 Postman 或 curl 验证 CRUD项目启动后先测一个最简单的 GET 接口。假设景点列表接口是/scenic/listcurl -X GET http://localhost:8080/scenic/list?pageNum1pageSize10 \ -H Content-Type: application/json如果返回 JSON 数组且字段完整说明 controller、service、mapper、数据库这条链路是通的。接着测 POST 新增curl -X POST http://localhost:8080/scenic/add \ -H Content-Type: application/json \ -d {scenicName:测试景点,price:99.00,address:测试地址}新增成功后用 GET 查一下是否真的写入了。如果 POST 返回成功但数据库没数据检查 service 层有没有加Transactional且方法内抛了异常被吞掉或者 MyBatis 的insert语句没写useGeneratedKeystrue导致主键没回填。4.3 跨域与静态资源访问如果项目带了前端页面Vue 打包后放进static目录常见问题是接口 404 或跨域。Vue 打包放进 SpringBoot 后路由要配history模式的话需要加一个 fallback controller 把非 API 请求转发到index.html。跨域则在 controller 上加CrossOrigin或在 config 里配WebMvcConfigurerConfiguration public class WebConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true); } }allowedOriginPatterns在 SpringBoot 2.4 以后替代了allowedOrigins用旧写法会报错。如果前端请求带 cookieallowCredentials(true)必须加且 origin 不能写*要用具体域名或 pattern。5. 避坑与排查那些让你怀疑人生的报错5.1 启动报时区错误现象启动时抛The server time zone value йʱ is unrecognized。 原因MySQL 服务器时区是系统默认JDBC 驱动无法识别中文时区名。 解决连接串加serverTimezoneAsia/Shanghai或者登录 MySQL 执行SET GLOBAL time_zone 8:00;。5.2 查询返回字段全为 null现象接口返回 200但 JSON 里字段都是 null。 原因数据库列名scenic_name和实体属性scenicName没开启驼峰映射或者 XML 里 resultType 写成了全限定名但别名没配。 解决application.yml里加map-underscore-to-camel-case: true或者 XML 里手写 resultMap 逐列映射。5.3 新增数据主键不回填现象insert 成功但返回的对象 id 为 null。 原因XML 的insert没加useGeneratedKeystrue keyPropertyid。 解决改成insert idinsert useGeneratedKeystrue keyPropertyid注意 keyProperty 要和实体类主键属性名一致。5.4 分页查询总数不对现象列表数据正确但分页组件显示总页数错误。 原因count 语句和 list 语句的 where 条件不一致或者 count 查的是全表。 解决把 where 条件抽成sql片段count 和 list 都引用同一个片段保证条件一致。5.5 打包后运行报找不到主类现象mvn package成功但java -jar报no main manifest attribute。 原因pom 里没配spring-boot-maven-plugin或者配了但没执行repackage。 解决在 build 节点加插件并绑定 repackage goal重新打包。6. 二次开发与进阶技巧让这套源码真正为你所用拿到一份能跑的源码只是起点真正让它变成你自己的东西得会改。第一个进阶方向是加权限控制。原始项目可能只有简单的登录校验你可以引入 Spring Security 或 Shiro把用户角色和菜单权限做成动态的。常见做法是加一张role表和user_role关联表登录时查角色接口上用注解拦截。第二个方向是慢 SQL 优化。旅游信息管理系统的景点查询如果数据量大LIKE %关键词%会全表扫描。我一般会先开 MyBatis 的 SQL 日志把logging.level.com.xxx.tourism.mapperDEBUG打开看实际执行的 SQL 和执行时间。如果某条查询超过 500ms考虑给scenic_name加索引或者把模糊查询改成全文索引。热词里“慢 SQL 优化”在这个场景下非常实用因为景点表往往是数据量最大的一张。第三个方向是接口文档自动化。手写接口文档容易和代码脱节引入 Swagger 或 Knife4j 后注解写在 controller 上文档自动生成。加依赖dependency groupIdcom.github.xiaoymin/groupId artifactIdknife4j-spring-boot-starter/artifactId version3.0.3/version /dependency然后在 config 里加EnableKnife4j和 Docket 配置启动后访问/doc.html就能看到所有接口。注意 SpringBoot 2.7 和 Knife4j 3.0.3 搭配时需要额外加spring.mvc.pathmatch.matching-strategyant_path_matcher否则启动报错。最后一个技巧是数据库脚本的版本管理。别每次改表都手动执行 SQL用 Flyway 或 Liquibase 把每次变更写成版本化脚本项目启动时自动执行。这样换一台机器部署时不用再翻聊天记录找“上次那个 alter 语句”。我自己的习惯是每次改完表结构立刻把变更写成V2__add_column.sql放进resources/db/migration下次启动自动生效。从那以后我每次拿到新项目都强制先跑一遍show tables和desc确认表结构再动代码。希望帮到你。本文还有配套的精品资源点击获取