在线图书借阅平台的设计与实现

对应的控制器实现了注册与登录逻辑，重点在于密码加密与 Token 生成：

@RestController
@RequestMapping("/api/user")
public class UserController {
    @Autowired
    private UserService userService;

    @PostMapping("/register")
    public Result register(@RequestBody UserRegisterDTO dto) {
        if (userService.checkUsernameExists(dto.getUsername())) {
            return Result.error("用户名已存在");
        }
        User user = new User();
        user.setUsername(dto.getUsername());
        // 密码加密
        user.setPassword(BCrypt.hashpw(dto.getPassword(), BCrypt.gensalt()));
        user.setEmail(dto.getEmail());
        user.setRole(0);
        user.setCreateTime(LocalDateTime.now());
        userService.save(user);
        return Result.success("注册成功");
    }

    @PostMapping("/login")
    public Result login(@RequestBody UserLoginDTO dto) {
        User user = userService.getByUsername(dto.getUsername());
        if (user == null || !BCrypt.checkpw(dto.getPassword(), user.getPassword())) {
            return Result.error("用户名或密码错误");
        }
        // JWT 生成
        String token = JwtUtil.generateToken(user.getId(), user.getRole());
        return Result.success(token);
    }
}

2.2 借阅业务逻辑

借阅是系统的核心事务，需要保证库存扣减与记录创建的原子性。这里使用了 Spring 的 @Transactional 注解。

@PostMapping("/borrow")
@Transactional
public Result borrowBook(@RequestParam Integer userId, @RequestParam Integer bookId) {
    Book book = bookService.getById(bookId);
    if (book == null || book.getAvailableCount() <= 0) {
        return Result.error("该图书暂无库存");
    }
    // 减少可借库存（原子操作）
    book.setAvailableCount(book.getAvailableCount() - 1);
    bookService.updateById(book);

    // 生成借阅记录
    BorrowRecord record = new BorrowRecord();
    record.setUserId(userId);
    record.setBookId(bookId);
    record.setBorrowDate(LocalDateTime.now());
    record.setDueDate(LocalDateTime.now().plusDays(30));
    record.setStatus(0); // 0-未归还
    borrowRecordService.save(record);

    return Result.success("借书成功，应还日期：" + record.getDueDate());
}

2.3 图书资源管理

图书的增删改查（CRUD）相对标准，但需要注意参数校验与异常处理。以下展示了按分类查询的逻辑，利用 LambdaQueryWrapper 动态构建 SQL。

@GetMapping("/search")
public Result searchBooks(
    @RequestParam(required = false) String keyword,
    @RequestParam(required = false) String category,
    @RequestParam(required = false) Boolean available
) {
    LambdaQueryWrapper<Book> wrapper = new LambdaQueryWrapper<>();
    if (StringUtils.hasText(keyword)) {
        wrapper.like(Book::getTitle, keyword).or().like(Book::getAuthor, keyword);
    }
    if (StringUtils.hasText(category)) {
        wrapper.eq(Book::Category, category);
    }
    if (available != null) {
        wrapper.eq(Book::getAvailableCount, available ? 1 : 0);
    }
    // 仅返回必要字段，优化性能
    wrapper.select(Book::getId, Book::getTitle, Book::getAuthor, Book::getCategory, Book::getAvailableCount);
    List<Book> books = bookService.list(wrapper);
    return Result.success(books);
}

三、优化与调试心得

3.1 SQL 性能瓶颈处理

问题现象：当图书总量超过 1 万条时，SELECT * FROM book WHERE available_count > 0 查询耗时超过 2 秒。

解决方案：

1. 添加索引：执行 ALTER TABLE book ADD INDEX idx_available (available_count);
2. 优化查询：修改 Controller，限定返回字段，避免全表扫描数据。

优化后效果：查询时间从 2.1s 降至 120ms。

3.2 JWT 令牌过期处理

问题现象：用户登录后，若 30 分钟内无操作，再次请求接口返回 401 未授权。

解决步骤：

1. 定位到 JwtUtil.java 中的过期时间配置。
2. 调整 expiration 参数为 2 小时（new Date(System.currentTimeMillis() + 2 * 60 * 60 * 1000)）。
3. 前端配合：在 Vue 中存储 JWT 时，通过拦截器自动刷新令牌。

3.3 代码规范性调整

初始生成的代码虽功能完整，但部分命名可读性不足。通过手动调整：

• 统一响应格式：修改 Result.java 为 {code: 200, msg: "success", data: {...}} 结构。
• 日志增强：在关键业务方法（如借阅、归还）中添加 @Slf4j 注解，记录操作流水。

四、总结

本次开发基于 Spring Boot 构建了完整的在线图书借阅系统，涵盖了用户认证、图书检索、借阅事务及逾期管理等核心链路。

项目亮点：

1. 分层架构清晰：Controller-Service-Mapper 分层符合企业级规范，便于后期维护。
2. 安全性保障：采用 BCrypt 加密密码，JWT 无状态认证，有效防止常见安全漏洞。
3. 性能优化意识：针对高频查询场景进行了索引优化与字段裁剪。

对于初学者而言，此类项目是理解 Web 开发全流程的绝佳实践。后续可进一步扩展预约排队、推荐算法等高级功能，以适应更复杂的业务场景。