韬貉先生
获得徽章 0
- #新人报道# 大创项目记录｜后端基础搭建：注册登录 + 版本兼容踩坑
继续做大创项目的后端，今天主要把用户注册登录功能完整跑通，顺便解决了一波版本兼容的问题。
一、今天完成了什么
1. 项目骨架：Spring Boot 4.0.x + mybatis-spring-boot-starter + MySQL，Maven 管理依赖
2. 用户模块：
· User 实体类
· UserMapper（注解写 SQL）
· UserServiceImpl 业务层（重复校验、登录验证）
· UserController 暴露 /api/user/register 和 /api/user/login
3. 接口测试：用 IDEA 自带的 HTTP Client 发请求，确认注册和登录返回正常
---
二、踩坑
1. JDK 版本不兼容
一开始装了 JDK 25，结果 Spring Boot 4.0.x 启动报错。
查官方文档：Spring Boot 4.0 要求 JDK 17+。
换回 JDK 17 后正常。
→ 以后用新框架时，第一件事看它支持的 JDK 版本，能省不少时间。
2. MyBatis 相关依赖版本要匹配
pom.xml 里我刚开始用了不匹配的 MyBatis 版本，导致启动时找不到类。
排查后发现，Spring Boot 4.0 需要配套的 mybatis-spring-boot-starter 4.0.x（专门适配 Spring Boot 4 的 starter）。
更新到对应版本后解决。
→ 依赖版本不是越高越好，要和 Spring Boot 的版本匹配，最好去 mvnrepository 看兼容性说明。
---
三、顺手用了 IDEA 的 HTTP Client
以前测试接口都是 Postman，今天发现 IDEA 自带 .http 文件可以直接发请求，写起来很方便
不用切窗口，写完就能跑，适合本地开发快速验证。
---
四、小结
今天把后端最基础的用户模块搭好了，虽然只是注册登录，但过程中把 JDK 版本、MyBatis 配套依赖的问题过了一遍，这些坑在项目初期踩掉，后面会顺畅很多。
下一步准备接入 JWT 做登录态，以及开始写大创项目的核心业务。展开评论1