技术实践笔记：WordPress 部署、MyBatis-Plus 接口设计与依赖排查

3. Service 层

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) {
        // 1. 校验用户是否存在
        checkUserExists(userId);
        checkUserExists(friendId);
        // 2. 检查是否已是好友
        if (relationMapper.existsRelation(userId, friendId)) {
            return false;
        }
        // 3. 双向添加关系
        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 扩展自定义 SQL。

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

数据库优化建议

Email 字段索引

在用户系统中，Email 常作为登录凭证或唯一标识。为其建立索引是提升查询性能的关键。

1. 提高查询效率：将 O(n) 降为 O(log n)，加速登录和密码重置流程。
2. 保证唯一性：通过 UNIQUE INDEX 防止重复注册。
3. 支持高级查询：优化特定后缀的查找需求。

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 的搭配，以及前后端工具的依赖传递。掌握这些底层原理，比单纯复制代码更能应对后续的挑战。