从 WordPress 到 MyBatis-Plus：一次开发环境搭建与接口实战笔记

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("用户不存在");
        }
    }
}

Mapper

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);
}

返回体统一

@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;
    }
}

数据库索引

用户系统的 Email 字段经常用来登录或找密码，加个唯一索引好处明显：

• 查询从全表扫变成索引快速定位，登录、重置密码都快很多。
• 唯一约束直接防止重复注册，不用额外代码检查。
• 按后缀查找也能用上前缀索引，省空间。

CREATE UNIQUE INDEX idx_email ON users(email);

当然，写性能会稍微降一点，但用户表大多读多写少，这点开销可以接受。如果字段太长，就建前缀索引。

前端依赖踩坑

用 OpenAPI 生成代码时，突然报 Cannot find module 'tslib'。TypeScript 运行时库没装。

解决：

1. 手动装一下：npm install tslib --save 或 yarn add tslib。
2. 检查 node_modules/tslib 和 package.json 确认已添加。
3. 还不行就删掉 node_modules 重装，缓存有时候会捣乱。

修完后 npm run openapi 就能跑通了。

环境问题总是最折腾人的。IDEA 版本、JDK 搭配、Maven 仓库路径，一个不对就卡半天。MyBatis-Plus 的接口设计其实套路固定，把校验和事务理顺就行。前端这些依赖缺失，知道排查方向了就快。别死磕，先看版本，再查依赖，大多能定位到。