简介：一份面向毕业设计与项目实践的SpringBoot考研资讯平台文档资源，适合计算机相关专业学生、Java后端开发者及需要快速搭建同类信息服务平台的人员参考。压缩包内共1个doc文件，整体大小6.65MB，目前已有46人学习下载。文档从摘要与目录切入，系统梳理了平台的整体设计方案：以Java+SpringBoot+MySQL为核心技术栈，详细说明学生前台（考研资讯、报考指南、资料信息、论坛、购物车、客服）与管理员后台（资讯管理、学生管理、资料分类、订单管理、系统管理）的功能结构，同时覆盖业务流程规划、数据库设计与系统测试等关键环节，并阐述了SpringBoot自动配置、内嵌Tomcat、模块化开发等特性对系统稳定性与可扩展性的支撑。通过研读这份文档，读者既能掌握考研资讯平台从需求分析到架构落地的完整思路，也能获得关于功能模块划分、权限分离设计和数据库表结构规划的可复用经验，为独立完成类似毕设课题或商业项目提供有力参考。
1. 从“springboot-考研资讯平台”这份标题说起：它到底要解决什么问题
看到“springboot-考研资讯平台.doc”这个标题，先别急着把它当成又一个 Spring Boot 毕设模板。这个题目背后是一个很具体的场景：考研学生要集中查阅院校资讯、专业课资料、备考打卡和学长经验，管理员要能对内容做审核和发布，而不是发一篇就立刻全网可见。它适合两类人：一是课程设计或毕业论文选了 Spring Boot 方向、不想只做图书管理那种 CRUD 的同学；二是想把一个资讯站快速落地的小团队。真正拉开差距的不是增删改查，而是内容发布状态、文件上传与访问、定时推送、权限控制这几块。下面我按数据模型、核心功能、安全性能、避坑、打包验证的顺序，把它写成一份能直接照着改的落地笔记。
2. 数据地基先行：考研资讯平台的角色、表结构与 Spring Boot 项目骨架
2.1 角色与核心流程：让内容先“审核”再上架，而不是直接可见
考研资讯平台最常见的误区，是只建一张“资讯表”，用一个布尔字段表示是否发布。学生端确实只看已发布内容，但管理端需要知道一篇文章是刚写的草稿、待审核、还是以前发布过又下线的。我一般会把内容状态做成一个枚举，而不是字段里写死 0 和 1。
public enum ArticleStatus { DRAFT(0, "草稿"), PENDING(1, "待审核"), PUBLISHED(2, "已发布"), OFFLINE(3, "已下线"); private final int code; private final String desc; ArticleStatus(int code, String desc) { this.code = code; this.desc = desc; } public int getCode() { return code; } public String getDesc() { return desc; } }这段枚举的作用，是让业务里所有判断状态的地方不再散落魔法数字。比如article.getStatus() == 2这种写法，时间一久没人知道 2 是什么；换成ArticleStatus.PUBLISHED.getCode()，读代码的人一眼就懂。平台角色上，我建议只保留两种：学生端用户ROLE_USER，后台管理用户ROLE_ADMIN。不要一上来就拆出“资讯审核员”“超管”“运营”一堆角色，毕设和早期项目根本用不上那么重的权限模型，后续要加也容易，直接扩一张角色表就行。
流程上，内容从作者提交开始，先进“待审核”，管理员审核通过后变为“已发布”。这里有个容易被忽略的点：修改已发布文章时，不要让修改结果立刻生效，而是重新进入“待审核”，等管理员再次通过。否则一个手滑把错误内容直接推到学生端，远比多审核一次更麻烦。
2.2 关键表设计：用户表、资讯表、资料文件表
表设计决定了这个项目后面好不好改。资讯表必须用LONGTEXT存正文，标题和摘要也要单独拆出来，方便列表页查询时不拖出整篇正文。下面两份建表 SQL，是这类平台最常用的基础模板。
CREATE TABLE `t_user` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL COMMENT '登录名', `password` VARCHAR(100) NOT NULL COMMENT 'BCrypt 加密后的密码', `role` VARCHAR(20) NOT NULL DEFAULT 'ROLE_USER' COMMENT '角色', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '1正常 0禁用', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';CREATE TABLE `t_article` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `title` VARCHAR(200) NOT NULL COMMENT '标题', `summary` VARCHAR(500) DEFAULT NULL COMMENT '摘要', `content` LONGTEXT COMMENT '正文', `type_id` BIGINT DEFAULT NULL COMMENT '资讯分类', `author_id` BIGINT NOT NULL COMMENT '发布人', `cover_url` VARCHAR(255) DEFAULT NULL COMMENT '封面图', `status` TINYINT NOT NULL DEFAULT 0 COMMENT '0草稿 1待审核 2已发布 3已下线', `view_count` INT NOT NULL DEFAULT 0 COMMENT '浏览量', `publish_time` DATETIME DEFAULT NULL COMMENT '首次发布时间', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, `deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除', PRIMARY KEY (`id`), KEY `idx_type_status` (`type_id`, `status`), KEY `idx_publish_time` (`publish_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='考研资讯表';用户表里的密码用BCrypt加密存储，这个不用犹豫，明文密码放数据库基本等于把后台管理权限送给别人。资讯表注意两个细节：一是tt_content不在普通索引里，搜索它用LIKE只能全表扫；考研资讯平台的搜索场景通常是标题和摘要，内容搜索可以等数据量大了再考虑 Elasticsearch。二是deleted字段配合 MyBatis-Plus 的逻辑删除，能在不真删数据的情况下让列表查询自动过滤。
2.3 工程结构和 Maven 依赖：Spring Boot 项目结构怎么摆才不乱
很多初学者会把 Controller、Service、Mapper 全堆在一个包里，项目跑到两三千行就乱成一团。Spring Boot 对包结构没有强约束，但按职责分层，后续加功能、加定时任务、加配置类时不用到处找文件。我常用的目录是这样：
src/main/java/com/example/kaoyan/ controller/ # 只放路由、参数接收、权限注解 service/ # 业务逻辑，不出现 HttpServletRequest mapper/ # MyBatis-Plus 的 Mapper 接口 entity/ # 数据库实体，一对一对应表 common/ # 统一返回 Result、全局异常、常量 config/ # WebMvc 配置、资源映射、拦截器注册 job/ # 定时任务依赖方面，用 Spring Boot 2.7 系列加 MyBatis-Plus 3.5 系列比较稳。Spring Boot 3 已经把javax换成了jakarta，网上一多半教程和答疑帖都还停留在 2.x，如果你是照着教程边查边写，2.7 会让你少熬夜。
<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.x</version> <relativePath/> </parent> <properties> <java.version>1.8</java.version> <mybatis-plus.version>3.5.3</mybatis-plus.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>${mybatis-plus.version}</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>io.jsonwebtoken</groupId> <artifactId>jjwt-api</artifactId> <version>0.11.5</version> </dependency> <dependency> <groupId>io.jsonwebtoken</groupId> <artifactId>jjwt-impl</artifactId> <version>0.11.5</version> <scope>runtime</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> </dependencies>这里有个参数要特别说明：JWT 用 jjwt 时不能只引一个jjwt-api，运行时还需要jjwt-impl，否则启动后调用Jwts.builder()会直接抛NoClassDefFoundError。这是很多人在登录模块上翻车的头号原因。MySQL 驱动版本不用自己写，交给 Boot 的依赖管理；如果你升到 Spring Boot 3.x，驱动坐标也要换掉，这个问题我放在第 5 章的避坑里细说。
3. 核心功能落地：资讯发布、搜索、文件上传与定时推送
3.1 资讯发布接口：参数校验、状态流转与事务
发布资讯是平台最核心的动作。接口层面只做参数接收和权限判断，真正组装数据的逻辑放到 Service 层。这里我先给出最精简的 Controller 和 Service 实现。
@RestController @RequestMapping("/api/article") public class ArticleController { private final ArticleService articleService; public ArticleController(ArticleService articleService) { this.articleService = articleService; } @PostMapping("/publish") public Result<Long> publish(@RequestBody @Validated ArticleDTO dto) { return Result.ok(articleService.publish(dto)); } }@Service public class ArticleServiceImpl extends ServiceImpl<ArticleMapper, Article> implements ArticleService { @Override @Transactional(rollbackFor = Exception.class) public Long publish(ArticleDTO dto) { Article article = new Article(); article.setTitle(dto.getTitle()); article.setSummary(dto.getSummary()); article.setContent(dto.getContent()); article.setTypeId(dto.getTypeId()); article.setAuthorId(CurrentUserHolder.get().getId()); article.setStatus(ArticleStatus.PENDING.getCode()); save(article); return article.getId(); } }这段代码有两个关键点。第一，@Transactional(rollbackFor = Exception.class)必须写明Exception.class，因为 Spring 默认只在运行时异常时回滚，IOException这类检查异常不会触发回滚。第二，CurrentUserHolder是登录拦截器写入当前用户信息的ThreadLocal，不要在 Service 里直接解析HttpServletRequest，那样会让 Service 依赖 Web 层，单元测试也难写。DTP 对象里应包含title、summary、content、typeId，校验规则用@NotNull、@NotBlank放在字段上，这样请求一进来就能被全局异常处理器拦截，而不是等到写库时报错。
3.2 关键词搜索与分页：MyBatis-Plus 查询器的组合用法
考研资讯平台最常见的搜索条件是关键词加分类，外加按发布时间倒序。MyBatis-Plus 的LambdaQueryWrapper可以避免拼接 SQL 字符串，我用起来最顺手的是这一套写法。
public IPage<ArticleVO> search(String keyword, Integer typeId, int page, int size) { Page<Article> p = new Page<>(page, size); LambdaQueryWrapper<Article> qw = new LambdaQueryWrapper<>(); qw.select(Article.class, field -> !field.getColumn().equals("content")); qw.eq(Article::getStatus, ArticleStatus.PUBLISHED.getCode()); qw.like(StringUtils.hasText(keyword), Article::getTitle, keyword); qw.eq(typeId != null && typeId > 0, Article::getTypeId, typeId); qw.orderByDesc(Article::getPublishTime); return articleMapper.selectPage(p, qw).convert(this::toVO); }这里最容易被忽略的是qw.select(...)。如果不排除content字段，列表页每次查询都会把一篇几千字的正文从数据库拖出来，流量一大性能立刻下滑。field -> !field.getColumn().equals("content")这种写法，是让 MyBatis-Plus 动态选择除content外的所有列，比手写select("id","title","summary", ...)少维护一堆字段名。分页对象Page的第一页页码从 1 开始，前端传page=0时会出现空数据，我一般在 Controller 做一次page <= 0 ? 1 : page的保护。
3.3 资料文件上传：别把文件丢进项目里，要映射成可访问的 URL
考研资讯平台经常要上传 PDF、真题压缩包和封面图。最省事但最坑的做法是把文件存到项目根目录或src/main/resources下，这样打包成 jar 后，重启一次文件就没了。正确做法是存到服务器外部目录，再通过 WebMvc 映射出来访问。
@PostMapping("/file/upload") public Result<String> upload(@RequestParam("file") MultipartFile file, @RequestParam(value = "dir", defaultValue = "common") String dir) { if (file.isEmpty()) { throw new BusinessException("上传文件为空"); } String ext = StringUtils.getFilenameExtension(file.getOriginalFilename()); if (ext == null || !allowedExt.contains(ext.toLowerCase())) { throw new BusinessException("不支持的文件类型"); } String datePath = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyyMM")); String fileName = UUID.randomUUID().toString().replace("-", "") + "." + ext; Path target = Paths.get(uploadRoot, datePath, fileName); try { Files.createDirectories(target.getParent()); file.transferTo(target); } catch (IOException e) { throw new BusinessException("文件保存失败，请检查磁盘目录权限"); } return Result.ok("/files/" + datePath + "/" + fileName); }uploadRoot建议配成一个绝对路径，比如/data/kaoyan/upload/，不要让用户通过参数传进去。文件名用 UUID 重命名，一是防止中文文件名乱码，二是不把用户原始文件名直接暴露在 URL 里。allowedExt白名单一般写jpg、png、pdf、zip、rar、doc、docx，禁止用户上传jsp、html，否则文件目录一旦被访达就能直接执行脚本。最后还要加一个资源映射才能访问：
@Configuration public class WebMvcConfig implements WebMvcConfigurer { @Value("${upload.root}") private String uploadRoot; @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/files/**") .addResourceLocations("file:" + uploadRoot); } }这个配置的坑在file:后的路径结尾。Windows 下是file:D:/data/upload/，Linux 下是file:/data/kaoyan/upload/，结尾必须带斜杠，否则 Spring 会把最后一个目录名当成文件名拼进 URL，访问时 404。
3.4 定时任务与提醒：Spring Boot 定时任务的 cron 与“丢任务”隐患
资讯平台里常见的定时任务是每天早上八点推送考研倒计时、汇总前一日热门文章。Spring Boot 做定时任务很简单，先开启调度，再写一个任务类。
@Configuration @EnableScheduling public class ScheduleConfig { }@Component public class DailyPushJob { private static final Logger log = LoggerFactory.getLogger(DailyPushJob.class); @Scheduled(cron = "0 0 8 * * ?") public void pushDailyHotArticles() { List<Article> topList = articleMapper.selectTopPublished(10); pushService.pushToWechat(topList); log.info("daily push finished, size={}", topList.size()); } }@Scheduled默认只在单线程里顺序执行所有任务。如果你写了多个任务，其中一个因为网络请求卡住，后面所有任务都会被堵住，表现为“今天推送了，明天再也没推”。我一般会在配置里给TaskScheduler设置线程池大小，至少两个线程，避免一个慢任务拖死全家。另外，cron 表达式是 6 位，从左到右是秒、分、时、日、月、周，不要从网上随手抄一个 7 位表达式，多出来的年份位 Spring 不会当兄弟，会直接报错。如果项目部署了多个实例，同一个定时任务会在每个实例上都跑一遍，学生就会收到重复推送，这个必须用分布式锁，或者先把任务收敛到单独一台机器上。
4. 让平台扛得住访问：统一返回、登录拦截、缓存与反向代理
4.1 统一响应与全局异常：前后端先把“接口长什么样”定下来
资讯平台一旦把接口对给前端，最怕每个人的接口返回格式都不一样。这个接口返回{code, message, data}，那个接口返回{success: true}，前端对接成本直线上升。最晚在写第二个接口之前，就要把统一响应类定死。
public class Result<T> { private int code; private String message; private T data; public static <T> Result<T> ok(T data) { Result<T> r = new Result<>(); r.code = 200; r.message = "ok"; r.data = data; return r; } public static <T> Result<T> fail(int code, String message) { Result<T> r = new Result<>(); r.code = code; r.message = message; return r; } }配合全局异常处理后，业务代码里抛出的任何BusinessException都会被包装成统一结构，前端只需要判断code。这里不要每个异常都返回 HTTP 500，参数校验失败返回 400，未登录返回 401，没权限返回 403，资源不存在返回 404，语义清晰才方便前端做弹窗提示。
4.2 JWT 登录与权限拦截：用拦截器和注解把后台保护起来
考研资讯平台有学生端还有管理员端，后台发布接口不能裸奔。我用的是 JWT + HandlerInterceptor 的方式，比 Spring Security 轻，又比在每个 Controller 里手写判断干净。
@Component public class JwtInterceptor implements HandlerInterceptor { private final TokenService tokenService; public JwtInterceptor(TokenService tokenService) { this.tokenService = tokenService; } @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (!(handler instanceof HandlerMethod)) { return true; } HandlerMethod handlerMethod = (HandlerMethod) handler; AuthRequired auth = handlerMethod.getMethodAnnotation(AuthRequired.class); if (auth != null) { String token = request.getHeader("Authorization"); LoginUser user = tokenService.parseToken(token); CurrentUserHolder.set(user); } return true; } }AuthRequired是一个自定义注解，标在需要登录的接口方法上。后台发布和审核接口再加一个@AdminOnly注解，在拦截器里校验LoginUser.getRole()是不是ROLE_ADMIN。整套流程下来，业务代码里看不到 token 解析，也看不到权限判断，Controller 只负责接收参数和返回结果。要注意的是，preHandle里不要只判断注解，接口方法上没标注解就应当直接放行，否则登录接口自己都会被拦截。
4.3 热点资讯缓存：Caffeine 与 Redis 到底怎么选
资讯平台的阅读热点非常集中，比如“国家线公布”“某校初试科目调整”这类文章，短时间会被大量学生点开。如果每一下都查数据库，MySQL 压力不小。单机部署时，Caffeine 本地缓存是最省事的方案。
@Configuration public class CacheConfig { @Bean public CacheManager cacheManager() { CaffeineCacheManager manager = new CaffeineCacheManager("article", "school"); manager.setCaffeine(Caffeine.newBuilder() .maximumSize(1000) .expireAfterWrite(Duration.ofMinutes(5))); return manager; } }缓存不到 1000 个热点 key，每条数据 5 分钟过期，对考研资讯平台这种规模已经够用。如果项目要水平扩展成多实例，本地缓存会出现“每个实例缓存不一样”的问题，这时候才需要上 Redis。不要一开始就上 Redis，那是给自己加部署复杂度；真到需要的时候，把CacheManager的实现换成RedisCacheManager就行，业务代码里的@Cacheable注解不用改。
4.4 Nginx 反向代理与限流：让 Spring Boot 端口不直接暴露
开发时localhost:8080无所谓，部署上线时一定要用 Nginx 挡在前面。释放一个实站端口不如配置一个简单的反向代理。
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=5r/s; upstream kaoyan_backend { server 127.0.0.1:8080; } server { listen 80; server_name kaoyan.example.com; client_max_body_size 20m; location /api/ { limit_req zone=api_limit burst=10 nodelay; proxy_pass http://kaoyan_backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } location /files/ { proxy_pass http://kaoyan_backend; } location / { root /opt/kaoyan/dist; try_files $uri $uri/ /index.html; } }limit_req限制每个 IP 每秒最多 5 个 API 请求，突发 10 个直接拒掉，这能挡住大部分爬虫和无脑刷新。client_max_body_size 20m是因为平台要上传 PDF 真题，Nginx 默认只允许 1M，不调大，文件上传会在代理层就被拦下来，后端日志里什么都看不到。如果前端 Vue 项目打包后放在同一台机器上，location /直接指到打包目录，就不用再做跨域配置。
5. 避坑指南：考研资讯平台开发中常见的 5 个翻车现场
5.1 Spring Boot 版本太高，javax 变 jakarta，编译直接报错
现象：新开的 Spring Boot 3.x 项目，把网上 2.x 的代码复制进来，一编译就报package javax.servlet does not exist，连HttpServletRequest都 import 不了。
原因：Spring Boot 3 和 Spring Framework 6 把 Java EE 的包名从javax.*换成了jakarta.*，这是底层变更，不是依赖冲突。
解决：最稳妥的办法是把 Spring Boot 降回 2.7.x，主流教程、MyBatis-Plus 兼容性、网上答疑全都对得上。实在要用 3.x，就把所有import javax.servlet.*改成import jakarta.servlet.*，同时把 MySQL 驱动坐标从mysql:mysql-connector-java换成com.mysql:mysql-connector-j。
5.2 定时任务不执行或重复执行
现象：@Scheduled方法写好了，启动日志也没有报错，但到了时间就是不跑；或者跑了一次之后，以后再也不跑。
原因：一是@EnableScheduling没加，Spring 根本不会扫描定时任务；二是 cron 表达式是 7 位，Spring 只认识 6 位，第 7 位会导致任务注册失败；三是任务里某个远程调用阻塞了线程，同一个调度线程池被拖死。
解决：先确认启动类或配置类上有@EnableScheduling，再数一遍 cron 是 6 位，最后给定时任务单独配置线程池。多实例部署时用 Redis 分布式锁或ShedLock，确保同一时刻只有一个实例能执行。
5.3 文件上传后访问 404，重启后文件直接消失
现象：上传时接口返回成功，前端拿到/files/202504/xxxx.pdf，放到浏览器访问却 404；还有一种情况是开发时能访问，重启项目后图片全没了。
原因：文件被写到了项目运行目录、target目录或临时目录里，这些位置会随部署环境变化被清掉。没有配置资源映射，Spring Boot 也不知道/files/**该去哪个磁盘目录找文件。
解决：把上传根目录配置成服务器固定路径，比如/data/kaoyan/upload/，不要用相对路径。然后实现WebMvcConfigurer.addResourceHandlers，把/files/**映射到file:+ 上传根目录。Windows 和 Linux 下路径结尾的斜杠都要注意，缺失会导致最后一个目录被拼成文件名。
5.4 下划线字段查出全是 null，页面上一片空白
现象：数据库字段叫publish_time，实体属性叫publishTime，列表页能查到记录数，但时间、类型这些字段全是 null，标题却有值。
原因：MyBatis-Plus 默认开启驼峰映射，但只对自动生成的 SQL 生效。如果你写了自定义 XML 的select，结果集没有配置resultMap，或者字段别名没写对，映射就断了。
解决：检查application.yml里map-underscore-to-camel-case是否为 true，MyBatis-Plus 默认是开的；自定义 SQL 里给每个字段加别名，或者直接配resultMap。最简单的排查方法是在日志里打开 SQL 输出，看查出来的列名和实体属性能不能对上。
5.5 跨域请求失败：前端调不到，登录接口一直报错
现象：Vue 开发服务器跑在 5173，Spring Boot 跑在 8080，前端发请求被浏览器拦截，控制台报 CORS 错误。
原因：前后端分离开发时，浏览器同源策略会拦截跨域请求。如果只靠后端@CrossOrigin注解解决，也只对当前 Controller 生效，拦截器抛出的 401、403 异常里同样需要处理跨域头。
解决：最简单可靠的方式是加一个全局的CorsFilter，允许指定来源、Authorization请求头和GET/POST/PUT/DELETE/OPTIONS方法。上线时如果用 Nginx 托管前端静态文件并反向代理/api，同源之后跨域问题就自然消失了。
5.6 事务不生效：明明插了多条数据，报错后还是留下脏数据
现象：在一个 Service 方法里先插入文章，再插入文章标签，标签插入失败后文章并没有回滚，数据库里留下半截数据。
原因：常见的有三种。一是方法被try-catch吞掉了异常，事务感知不到；二是同一个类内部this调用另一个@Transactional方法，Spring 的代理没有介入；三是数据表用了 MyISAM 引擎，根本不支持事务。
解决：先把表引擎全部改成 InnoDB，这是最容易踩的隐蔽坑。然后在 Service 方法上写@Transactional(rollbackFor = Exception.class)，不要在事务方法内部自己吞异常。同类内部调用问题，可以把事务方法放到另一个 Service 类里注入调用，或者用@Lazy注入自身代理。
6. 从 Spring Boot 自动装配原理看配置失效，再谈打包验证
6.1 配置没生效，先怀疑自动装配的条件
很多人改配置无效时会折腾半天，其实根子在自动装配原理上。@SpringBootApplication由@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan组成，其中自动装配会去读取META-INF/spring.factories或AutoConfiguration.imports文件，按条件装出一批默认Bean。这些条件包括@ConditionalOnMissingBean、@ConditionalOnProperty等。也就是说，你自己定义了一个CacheManager，自动装配发现已经有这个Bean，就不会再创建它的默认版本；反过来，你的配置类没有被主程序包扫描到，自动装配的默认配置就接管了。这块也是 springboot 面试题里常被追问的一环，把它理解成“按条件注册 Bean”，排查方向和心态都会稳很多。
6.2 打包部署与自测清单
项目收尾时，我的习惯是先打包再部署，部署完按用户操作链路完整走一遍。命令行是最直接的方式。
mvn -DskipTests package java -jar target/kaoyan-platform.jar --spring.profiles.active=prod打包前确认application-prod.yml里的数据库地址、上传目录、JWT 密钥都换成生产配置，不要把自己电脑上的localhost带上线。验证时不要只点几个页面就算完，至少跑一遍“学生注册 → 登录 → 浏览资讯 → 搜索关键词 → 下载资料 → 管理员审核发布 → 第二天早上确认定时推送”这条链路。以前我就吃过亏，定时推送任务把远程接口调用直接写在@Scheduled方法里，没有单独隔离线程池，结果对方服务响应慢，Tomcat 线程被一个个拖死，网站整个无响应。后来我给自己立了个规矩：凡是定时任务里涉及远程调用或批量数据处理的，必须单独用队列加线程池，绝不让调度线程替外部接口的延迟买单。这个教训后来救了我好几次，也希望帮到你。
本文还有配套的精品资源，点击获取
