WordPress 基础配置与 Spring Boot + MyBatis-Plus 开发实战记录

2. Controller 层

@RestController
@RequestMapping("/friends")
@RequiredArgsConstructor
public class FriendController {
    private final FriendService friendService;

    @PostMapping
    public Result<Boolean> addFriend(@RequestBody @Valid FriendRequest request) {
        return Result.success(friendService.addFriend(request.getUserId(), request.getFriendId()));
    }

    @DeleteMapping
    public Result<Boolean> deleteFriend(@RequestBody @Valid FriendRequest request) {
        return Result.success(friendService.deleteFriend(request.getUserId(), request.getFriendId()));
    }

    @GetMapping("/{userId}")
    public Result<List<FriendDTO>> getFriends(@PathVariable Integer userId) {
        return Result.success(friendService.getFriends(userId));
    }

    @GetMapping("/check")
    public Result<Boolean> isFriend(@RequestParam Integer userId, @RequestParam Integer friendId) {
        return Result.success(friendService.isFriend(userId, friendId));
    }

    @Data
    static class FriendRequest {
        @NotNull
        private Integer userId;
        @NotNull
        private Integer friendId;
    }
}

3. Service 层

@Service
@RequiredArgsConstructor
public class FriendServiceImpl implements FriendService {
    private final UserMapper userMapper;
    private final FriendRelationMapper relationMapper;

    @Override
    @Transactional
    public boolean addFriend(Integer userId, Integer friendId) {
        checkUserExists(userId);
        checkUserExists(friendId);
        if (relationMapper.existsRelation(userId, friendId)) {
            return false;
        }
        // 双向添加关系
        relationMapper.insert(new FriendRelation(userId, friendId));
        relationMapper.insert(new FriendRelation(friendId, userId));
        return true;
    }

    @Override
    @Transactional
    public boolean deleteFriend(Integer userId, Integer friendId) {
        relationMapper.deleteRelation(userId, friendId);
        relationMapper.deleteRelation(friendId, userId);
        return true;
    }

    @Override
    public List<FriendDTO> getFriends(Integer userId) {
        return relationMapper.selectFriendList(userId).stream()
                .map(user -> new FriendDTO(user.getId(), user.getNickname(), user.getAvatar()))
                .collect(Collectors.toList());
    }

    @Override
    public boolean isFriend(Integer userId, Integer friendId) {
        return relationMapper.existsRelation(userId, friendId);
    }

    private void checkUserExists(Integer userId) {
        if (userMapper.selectById(userId) == null) {
            throw new BusinessException("用户不存在");
        }
    }
}

4. Mapper 层 (MyBatis-Plus)

实体类

@Data
@TableName("user_friend_relation")
public class FriendRelation {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Integer userId;
    private Integer friendId;
    private LocalDateTime createTime;
}

接口定义

public interface FriendRelationMapper extends BaseMapper<FriendRelation> {
    @Select("SELECT COUNT(1) FROM user_friend_relation " +
            "WHERE user_id = #{userId} AND friend_id = #{friendId}")
    boolean existsRelation(@Param("userId") Integer userId, @Param("friendId") Integer friendId);

    @Delete("DELETE FROM user_friend_relation " +
            "WHERE user_id = #{userId} AND friend_id = #{friendId}")
    int deleteRelation(@Param("userId") Integer userId, @Param("friendId") Integer friendId);

    @Select("SELECT u.* FROM user u " +
            "JOIN user_friend_relation r ON u.id = r.friend_id " +
            "WHERE r.user_id = #{userId}")
    List<User> selectFriendList(Integer userId);
}

5. 统一返回结构

@Data
public class Result<T> {
    private int code;
    private String msg;
    private T data;

    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(200);
        result.setMsg("success");
        result.setData(data);
        return result;
    }
}

6. 关键设计说明

• 事务控制：增删操作必须添加 @Transactional 注解。
• 参数校验：结合 @Valid 与 @NotNull 确保入参合法。
• 性能优化：避免 N+1 问题，建议使用 JOIN 查询；数据库层面建立联合索引 (user_id, friend_id)。

数据库索引优化

为 email 字段建立索引是提升系统性能的关键实践。

核心原因

1. 提高查询性能：将查找复杂度从 O(n) 降至 O(log n)，加速登录、密码重置等场景。
2. 保证唯一性：通过唯一索引防止重复注册。
3. 高级查询支持：优化前缀查询或特定模糊匹配。

注意事项

• 写入权衡：索引会轻微降低写入速度，但读取频繁的场景利大于弊。
• 类型选择：普通索引用于查询，唯一索引用于约束。
• 长度考虑：长字符串字段可考虑前缀索引（如 MySQL 的 email(50)）。

SQL 示例

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    email VARCHAR(255) NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    UNIQUE INDEX idx_email (email)
);

前端依赖问题解决

在使用 OpenAPI 工具生成前端代码时，常遇到 tslib 模块缺失报错。

错误现象

Error: Cannot find module 'tslib'
Require stack: ...

解决方案

1. 手动安装依赖：

   npm install tslib --save
   # 或使用 yarn
   yarn add tslib
   

2. 验证结构：检查 node_modules/tslib 是否存在。
3. 检查配置：确保 package.json 中包含 tslib 依赖项。

修复后重新运行 npm run openapi 即可正常生成。

总结

技术栈的整合往往伴随着细节排查。从环境搭建到代码生成，再到依赖管理，每一步都需要关注版本兼容性与规范遵循。掌握这些最佳实践，能有效减少开发过程中的试错成本。