企业官网建设流程全解析

Java毕业设计新手避坑指南：从选题到部署的完整技术路径

摘要：许多计算机专业学生在完成Java毕业设计时，常因缺乏工程经验陷入技术选型混乱、架构耦合严重或部署流程复杂等困境。本文面向零实战经验的新手，系统梳理从需求分析、技术栈选择（Spring Boot + MyBatis + MySQL）到CI/CD部署的全流程，提供可运行的模块化代码模板，并重点解析常见陷阱如事务失效、N+1查询、权限绕过等。读者将获得一套结构清晰、安全合规且易于扩展的毕业设计参考实现，显著降低开发成本与答辩风险。

1. 背景痛点：为什么“能跑”≠“能毕业”

在实验室里，很多同学的代码第一次跑通就长舒一口气，结果答辩时被老师三连问：

• “如果并发高一点，你的事务会不会脏读？”
• “这个接口谁都能调，权限控制在哪里？”
• “现场演示一下回滚，你确定写了单元测试？”

常见误区总结如下：

1. 盲目追新：把“毕业设计”做成“技术秀场”，引入尚不成熟的微服务、消息队列，结果分布式事务把自己绕晕。
2. 零安全考虑：明文存密码、SQL拼接、JWT 永不过期，老师一抓一个准。
3. 无自动化测试：main 方法手动跑一遍就算“测试通过”，现场演示时数据库刚好被隔壁班改脏。
4. 开发/生产不一致：Windows 写代码、Linux 部署，路径、大小写、编码、日志全翻车。
5. 文档缺失：README 只有一句“run main”，答辩前夜通宵截图补材料。

一句话：能跑只是起点，能维护、能扩展、能回滚，才配得上“工程”二字。

2. 技术选型对比：Spring Boot 为什么是最优解

结论：

1. 导师要求 Java 技术栈，直接排除 3、4。
2. SSM 的 XML 配置对新手是“天书”，Spring Boot 几乎零 XML，能把注意力放在业务。
3. Spring Boot 社区示例多、CI/CD 教程成熟，GitHub 一搜一大把，出了问题能抄到答案——这对毕设排错至关重要。

3. 核心实现细节：模块化代码模板

下面以“校园二手书交易平台”为例，展示用户、商品、订单三大模块的最小可运行骨架。代码均按 Clean Code 要求：

• 类名见名知意
• 方法不超过 30 行
• 关键逻辑必写注释

3.1 项目结构（Package By Feature）

tree -L 2 -d com.secondbook ├── user │ ├── UserController │ ├── UserService │ ├── UserMapper │ └── model │ ├── UserEntity │ └── UserDTO ├── book │ ├── BookController │ └── … ├── order │ └── … ├── common │ ├── GlobalExceptionAdvice │ └── PageResp └── SecondbookApplication

3.2 用户认证：JWT + ThreadLocal

1. 登录成功后返回 JWT，前端每次请求带Authorization: Bearer <token>
2. 拦截器解析 JWT，把 userId 放入UserHolder.save(userId)（ThreadLocal 封装），Service 层随时UserHolder.get()拿到当前用户，避免层层传参。

关键代码：

@Component public class LoginInterceptor implements HandlerInterceptor { public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { String token = request.getHeader("Authorization"); if (token == null || !token.startsWith("Bearer ")) throw new BizException("缺失令牌"); String userId = JwtUtil.verify(token.substring(7)); UserHolder.save(Long.valueOf(userId)); // ThreadLocal return true; } }

3.3 数据持久化：MyBatis-Plus + 分页插件

• 只写接口，不写实现：继承BaseMapper<T>即可。
• 分页统一返回PageResp<T>，前端无感知。

@RestController @RequestMapping("/book") public class BookController { @Resource private BookService bookService; @GetMapping public PageResp<BookDTO> list(@RequestParam(defaultValue = "1") int current, @RequestParam(defaultValue = "10") int size) { return bookService.pageBooks(current, size); } }

3.4 事务与 DTO 解耦

• Service 入参用 DTO，出参用 VO，绝不把 Entity 暴露给 Controller，防止字段泄露或误赋值。
• @Transactional只加在 Service写操作公有方法，且同类内调用无效（Spring AOP 代理限制）。

@Service public class OrderService { @Transactional(rollbackFor = Exception.class) // 显式声明回滚 public Long createOrder(CreateOrderDTO dto){ // 1. 扣减库存 boolean ok = bookMapper.decreaseStock(dto.getBookId(), dto.getQuantity()); if (!ok) throw new BizException("库存不足"); // 2. 创建订单 OrderEntity order = OrderEntity.builder() .userId(UserHolder.get()) .bookId(dto.getBookId()) .quantity(dto.getQuantity()) .build(); orderMapper.insert(order); return order.getId(); } }

3.5 RESTful 规范

• 统一返回包装类R<T>，含code、msg、data三字段。
• 错误码用枚举，禁止魔法数字。

@Getter @AllArgsConstructor public enum ResultCode { SUCCESS(0, "成功"), PARAM_ERROR(1001, "参数错误"), UNAUTHORIZED(2001, "未登录"), SYSTEM_ERROR(5001, "系统繁忙"); private final int code; private final String msg; }

4. 性能与安全：把“坑”提前埋好

1. SQL 注入：MyBatis#{}占位符已防，禁止${}拼接。
2. 密码加密：使用 BCrypt，不可逆；每用户随机盐，彩虹表失效。
3. 接口幂等：订单创建带clientId字段，数据库建唯一索引(user_id, client_id)，重复提交直接返回原订单号。
4. N+1 查询：MyBatis-Plus 默认left join一次把关联字段带出，关闭延迟加载，否则循环取列表会爆炸。
5. 慢 SQL 监控：p6spy 打印耗时 >500ms 语句，答辩现场老师问性能，直接拿日志截图。

5. 生产环境避坑：本地跑≠服务器稳

1. 端口与上下文路径
   • 本地server.port=8080，服务器若被占用，启动即挂。application-prod.yml改成 8081 并加server.servlet.context-path=/secondbook，Nginx 反代时不会冲突。
2. 日志目录
   • 服务器没有 D 盘，logging.file.path=/var/log/secondbook提前建好目录并赋权，否则 Spring Boot 默认写/tmp，重启系统日志被清空。
3. 数据库连接池
   • 默认 Hikari 连接数 10，云服务器 1G 内存扛不住，maximum-pool-size=5足够，再大反而 OOM。
4. 时区与编码
   • 服务器 UTC、MySQL 东八区，存时间用 datetime(6) + 字段 ON UPDATE CURRENT_TIMESTAMP，Java 端spring.jackson.time-zone=GMT+8，否则订单时间差 8 小时，答辩现场翻车。
5. 自动化部署
   • GitHub Actions 免费 2000 分钟/月，push 到 main 分支自动mvn package+scp到云主机重启服务，全程 3 分钟，老师看你当场发版，印象分 +20。

6. 完整可运行架构图

下图是“校园二手书平台”最小骨架，每个箭头都能一句话讲清作用，答辩 PPT 直接贴。

7. 把模板变“自己的”：给毕设加分的三个方向

1. 业务扩展
   • 加上“扫码收书”小程序程序，把移动端页面做成 PWA，老师手机扫码直接下单，现场演示效果炸裂。
2. 技术深化
   • 把订单模块拆成独立 jar，用 Spring Cloud OpenFeign 做内部调用，微服务雏形即可，无需全套 Netflix。
3. 数据洞察
   • 接入 ECharts 做“月度成交量”折线图，MySQL 聚合查询 + 定时任务，让老师看到你“会 SQL 也会可视化”。

8. 结语：从课程知识到工程能力

毕业设计不是“最后一门课”，而是第一次真正对自己代码全生命周期负责。把本文模板跑通后，不妨问自己三个问题：

• 如果明天需求改成“支持二手手机”，我要改哪些文件？
• 如果下周用户量翻十倍，哪段 SQL 最先撑不住？
• 如果一年后我忘了业务细节，README 能否让我 10 分钟重新跑起来？

能回答清楚，你就拥有了工程能力——这比任何新技术都保值。祝你答辩顺利，把“坑”留给文章，把亮点留给自己。