很多同学在做基于 Spring Boot 的毕业设计时，往往只追求功能实现，忽略了代码质量和工程化规范，导致项目结构混乱、难以维护，最终只能算是一个“玩具代码”。今天，我们就来聊聊如何让你的 Spring Boot 毕设项目摆脱“玩具”标签，向企业级项目看齐。

1. 背景痛点：那些年我们踩过的“坑”

回想一下，你的项目是不是也存在这些问题？这些问题往往是“玩具代码”的典型特征。

• 全局异常处理缺失：Controller 里到处都是 try-catch，异常信息直接抛给前端，用户体验差，后端日志也混乱不堪。
• 日志追踪困难：只在控制台打印 System.out.println，线上出问题根本找不到线索，调试全靠猜。
• 配置硬编码满天飞：数据库密码、第三方 API 密钥直接写在代码里，换个环境就得改代码，既不安全也不灵活。
• 代码结构混乱：业务逻辑、数据访问、控制层代码搅在一起，牵一发而动全身，加个新功能都胆战心惊。
• 接口设计随意：返回格式五花八门，没有统一的成功/失败规范，前端对接起来非常痛苦。
• 缺乏基础安全防护：SQL 注入、越权访问、重复提交等问题完全没有考虑。

2. 技术选型对比：为什么是这套组合拳？

面对琳琅满目的技术栈，选择一套稳定、高效、易上手的组合至关重要。对于本科毕设而言，我强烈推荐 Spring Boot + MyBatis-Plus + Lombok + Validation 这套“黄金搭档”。

• 为什么是 Spring Boot？ 它提供了“约定大于配置”的理念，内嵌了 Tomcat 等 Web 服务器，让你几乎零配置就能启动一个 Web 应用。这极大地简化了项目搭建过程，让你能更专注于业务逻辑。
• 为什么是 MyBatis-Plus 而不是原生 MyBatis 或 JPA？ MyBatis-Plus 在 MyBatis 基础上做了强大的增强，提供了通用的 CRUD 操作（无需手写 XML）、强大的条件构造器、分页插件等。对于毕设中大量的单表操作，它能极大减少重复的 SQL 编写，提升开发效率。相比 JPA，它的 SQL 更直观，对于从 SQL 学起的同学更友好。
• 为什么用 Lombok？ 它能通过注解自动生成 Getter、Setter、构造器、toString() 等方法，让 POJO 类变得非常简洁，避免了大量样板代码。
• 为什么用 Validation？ 它提供了声明式的参数校验注解（如 @NotNull, @Email），可以非常优雅地在 Controller 层对入参进行校验，避免将校验逻辑散落在业务代码中。

这套组合在开发效率、代码简洁度和学习成本之间取得了很好的平衡，非常适合在有限时间内完成一个高质量的毕设项目。

3. 核心实现细节：搭建清晰的分层架构

一个结构清晰的项目是工程化的基础。标准的 MVC 分层依然是最佳实践。

3.1 项目分层（controller / service / mapper）

• Controller 层：负责接收和响应 HTTP 请求，职责应尽量“薄”。它只做参数校验（使用 @Validated）、调用 Service 层、组装统一响应体。不应包含任何业务逻辑。
• Service 层：核心业务逻辑层。这里处理具体的业务规则、流程编排、事务管理等。Service 接口定义契约，ServiceImpl 类负责实现。
• Mapper 层（或 Repository 层）：数据持久层。使用 MyBatis-Plus 的 BaseMapper 或自定义的 Mapper 接口，负责与数据库直接交互。

3.2 统一响应体设计

这是让接口规范化的关键一步。定义一个通用的响应类，例如 Result<T>。

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Result<T> {
    private Integer code; // 状态码，如 200成功，500失败
    private String msg; // 提示信息
    private T data; // 响应数据

    public static <T> Result<T> success(T data) {
        return new Result<>(200, "操作成功", data);
    }

    public static <T> Result<T> success(String msg, T data) {
        return new Result<>(200, msg, data);
    }

    public static <T> Result<T> error(String msg) {
        return new Result<>(500, msg, null);
    }
    // 可以定义更多静态工厂方法
}

这样，所有 Controller 方法都返回 Result<T>，前端就能以统一的方式处理响应。

4. 核心代码示例：从“能用”到“好用”

光有分层还不够，我们需要一些“利器”来提升代码质量。

4.1 全局异常处理器

这是消除 Controller 中 try-catch 块的法宝。使用 @RestControllerAdvice 注解。

@RestControllerAdvice
@Slf4j // 使用 Lombok 的日志注解
public class GlobalExceptionHandler {

    /**
     * 处理业务异常
     */
    @ExceptionHandler(BusinessException.class)
    public Result<Void> handleBusinessException(BusinessException e) {
        log.warn("业务异常：{}", e.getMessage());
        return Result.error(e.getMessage());
    }

    /**
     * 处理参数校验异常（JSR-303）
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Result<Void> handleValidException(MethodArgumentNotValidException e) {
        String message = e.getBindingResult().getAllErrors().stream()
                .map(DefaultMessageSourceResolvable::getDefaultMessage)
                .collect(Collectors.joining("; "));
        log.warn("参数校验失败：{}", message);
        return Result.error(message);
    }

    /**
     * 处理其他所有未捕获异常
     */
    @ExceptionHandler(Exception.class)
    public Result<Void> handleException(Exception e) {
        log.error("系统异常：", e); // 这里记录详细的错误堆栈，方便排查
        return Result.error("系统繁忙，请稍后再试");
    }
}

4.2 防重复提交注解（简易版）

利用 Spring AOP 和 Redis 可以轻松实现。这里展示一个基于请求方法和参数生成唯一键的思路。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PreventDuplicateSubmission {
    long expireTime() default 3; // 锁的过期时间，单位秒
}

@Aspect
@Component
@Slf4j
public class DuplicateSubmissionAspect {

    @Autowired
    private RedisTemplate<String, String> redisTemplate;

    @Around("@annotation(preventDuplicateSubmission)")
    public Object around(ProceedingJoinPoint joinPoint, PreventDuplicateSubmission preventDuplicateSubmission) throws Throwable {
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        HttpServletRequest request = attributes.getRequest();

        // 生成唯一键：用户标识 + 请求路径 + 方法参数（简易版，生产环境需更严谨）
        String userId = "anonymous"; // 实际应从Token或Session中获取
        String uri = request.getRequestURI();
        String args = Arrays.toString(joinPoint.getArgs());
        String key = "dup:submit:" + userId + ":" + uri + ":" + args;

        // 使用 Redis setIfAbsent 实现分布式锁效果
        Boolean success = redisTemplate.opsForValue().setIfAbsent(key, "1", Duration.ofSeconds(preventDuplicateSubmission.expireTime()));
        if (Boolean.TRUE.equals(success)) {
            try {
                return joinPoint.proceed(); // 执行业务方法
            } finally {
                // 业务执行完成后，可以手动删除key，或者等待自动过期
                // redisTemplate.delete(key);
            }
        } else {
            throw new BusinessException("请勿重复提交");
        }
    }
}

在需要防重的 Controller 方法上加上 @PreventDuplicateSubmission() 注解即可。

5. 性能与安全考量：为项目穿上“铠甲”

一个健壮的项目必须考虑这些。

• SQL 注入防护：坚持使用 MyBatis/MyBatis-Plus 的 #{} 预编译占位符，绝对不要在 XML 或注解中用字符串拼接 ${} 来拼接用户输入。
• 敏感信息脱敏：在返回用户信息、手机号、邮箱等数据时，使用 Jackson 的 @JsonSerialize 注解配合自定义序列化器，或者在 DTO 层进行手动脱敏。
• JWT 令牌刷新机制：不要只用一个 Access Token。可以采用 Access Token（短期有效，如2小时）+ Refresh Token（长期有效，如7天）的方案。当 Access Token 过期后，前端用 Refresh Token 去请求一个新 Access Token，无需用户重新登录。这需要在服务端维护 Refresh Token 的有效性（如存入 Redis 并设置过期时间）。

6. 生产环境避坑指南

想让你的项目真正“跑起来”，这些配置很重要。

6.1 数据库连接池配置

Spring Boot 默认使用 HikariCP，性能很好。但在 application.yml 中建议调整以下参数：

spring:
  datasource:
    hikari:
      maximum-pool-size: 20 # 根据数据库性能和并发量调整
      minimum-idle: 5
      connection-timeout: 30000 # 连接超时时间(ms)
      idle-timeout: 600000 # 连接空闲超时时间(ms)
      max-lifetime: 1800000 # 连接最大生命周期(ms)

6.2 跨域处理

如果前端单独部署，需要解决跨域问题。可以配置一个全局的 Cors 过滤器。

@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**") // 对所有接口生效
                .allowedOriginPatterns("*") // 允许的源，生产环境应指定具体域名
                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
                .allowedHeaders("*")
                .allowCredentials(true)
                .maxAge(3600);
    }
}

6.3 Profile 多环境隔离

使用 application-{profile}.yml 文件来隔离不同环境（开发、测试、生产）的配置。

• application-dev.yml：开发环境，连接本地数据库，开启 Swagger 等调试工具。
• application-prod.yml：生产环境，连接线上数据库，关闭调试信息，配置日志级别和路径。

在启动时通过 --spring.profiles.active=prod 参数来激活指定环境的配置。

写在最后

遵循以上这些实践，你的 Spring Boot 毕设项目将不再是脆弱的“玩具代码”，而会成为一个结构清晰、易于维护、具备一定健壮性的“准生产级”项目。这不仅能让你在答辩时更有底气，更重要的是，这个过程本身是对你工程化思维和编码规范的一次极佳训练。

最后，不妨问自己一个问题：你的毕设项目，是否具备了被一个真实企业级项目复用或参考的潜力？ 如果答案是肯定的，或者你正朝着这个方向努力，那么恭喜你，你已经超越了大多数同学。更进一步，不妨考虑将你的代码开源到 GitHub 等平台，接受更多开发者的 Review 和 Star，这将是证明你能力的最好方式，也是你技术生涯一个闪亮的起点。