一、概述

个人中心是知识库系统的用户门户,承载着用户信息展示、个人资料管理、密码修改、用户数据统计等核心功能。本文将从数据库层到前端层,完整实现一个功能齐全、可直接运行的个人中心。

1.1 功能定位

个人中心作为用户自助管理的核心入口,提供以下功能:

功能模块说明使用场景
用户信息展示展示头像、用户名、邮箱、角色等基本信息用户查看个人资料
个人资料编辑修改用户名、邮箱、部门、职位、个人简介用户更新个人信息
头像上传上传并裁剪个人头像个性化设置
密码修改验证旧密码后设置新密码安全设置
用户数据统计展示个人发布的文档数、获赞数个人数据看板
活动时间线展示最近的操作记录和活跃情况活动回顾
安全退出确认后退出登录并清除凭证安全登出

1.2 现状分析

当前项目的个人中心(ProfilePage.tsx)存在以下待完善的问题:

现有功能:
✅ 用户信息展示(头像、用户名、邮箱、角色标签)
✅ 个人资料编辑表单(用户名、邮箱、部门、职位、个人简介)
✅ 头像上传(JPG/PNG,限制2MB)
✅ 密码修改(验证旧密码 → 新密码 → 确认密码)
✅ 安全退出(Modal确认 → 清除Token → 跳转登录页)

待完善的问题:
❌ 文档数和获赞数硬编码为 0,未从后端获取真实数据
❌ remark 字段在 Java 实体类中存在,但数据库缺少该列
❌ UserUpdateDTO 已定义但未被 Controller 使用
❌ user.service.ts 中多个方法(updateProfile、getUserStats 等)
   调用不存在的后端端点
❌ 缺少用户活动时间线
❌ 个人简介(remark/bio)字段无法持久化

1.3 架构设计

图片.png

数据流说明:

  1. 读路径:ProfilePage 加载 → GET /auth/me 获取用户信息 → GET /users/me/stats 获取统计数据 → 渲染页面
  2. 写路径:表单提交 → PUT /users/profile 更新用户资料 → 刷新页面状态
  3. 统计查询:从 kb_document 跨库视图查询当前用户的文档数、获赞数

二、数据库设计

2.1 问题分析

kb-user-auth 服务连接的数据库是 kb_user,而文档数据存储在 kb_document 库的 kb_document 表中。两个数据库之间默认为隔离状态,无法直接跨库查询。

解决方案是使用 MySQL 的跨库视图(Federated View),在 kb_user 库中创建一个名为 kb_document 的视图,指向 kb_document.kb_document 表。

2.2 执行数据库升级

创建 SQL 迁移文件 sql/15_kb_user_profile_upgrade.sql:

-- =====================================================
-- kb_user 数据库 - 个人中心功能升级
-- 1. 添加 remark 字段(个人简介)
-- 2. 创建 kb_document 跨库视图(用于用户统计查询)
-- =====================================================

SET NAMES utf8mb4;
USE `kb_user`;

-- =====================================================
-- 1. 添加 remark 字段
-- =====================================================
ALTER TABLE `kb_user`
    ADD COLUMN IF NOT EXISTS `remark` VARCHAR(500) DEFAULT NULL COMMENT '个人简介/备注'
    AFTER `position`;

-- =====================================================
-- 2. 创建 kb_document 跨库视图(只读)
--    用于查询用户发布的文档数、获赞数、浏览量
-- =====================================================
DROP VIEW IF EXISTS `kb_document`;
CREATE VIEW `kb_document` AS
SELECT
    id, title, author_id, author_name, category_id, status,
    view_count, like_count, favorite_count, comment_count,
    is_public, is_top, is_recommend, document_type, source,
    cover_image, tags, summary, content_id, content_length,
    sort, allow_comment, publish_time, create_time, update_time,
    create_by, update_by, deleted
FROM kb_document.kb_document;

SELECT 'kb_user 个人中心功能升级SQL执行完成!' AS message;

2.3 执行 SQL

# 方式一:完整执行 SQL 文件
mysql -u root -p < sql/15_kb_user_profile_upgrade.sql

# 方式二:手动执行(如果 remark 列已存在,只需创建视图)
mysql -u root -p kb_user -e "
DROP VIEW IF EXISTS kb_document;
CREATE VIEW kb_document AS
SELECT
    id, title, author_id, author_name, category_id, status,
    view_count, like_count, favorite_count, comment_count,
    is_public, is_top, is_recommend, document_type, source,
    cover_image, tags, summary, content_id, content_length,
    sort, allow_comment, publish_time, create_time, update_time,
    create_by, update_by, deleted
FROM kb_document.kb_document;
"

2.4 验证视图

mysql -u root -p kb_user -e "SHOW FULL TABLES WHERE Table_type = 'VIEW';"

# 预期输出:
# +------------------+------------+
# | Tables_in_kb_user | Table_type |
# +------------------+------------+
# | kb_document      | VIEW       |
# +------------------+------------+

# 测试查询
mysql -u root -p kb_user -e "SELECT COUNT(*) FROM kb_document WHERE deleted = 0;"

2.5 统计查询 SQL

个人中心的统计数据通过以下 SQL 从跨库视图获取:

-- 查询用户文档数
SELECT COUNT(*) FROM kb_document
WHERE author_id = ? AND deleted = 0;

-- 查询用户总获赞数
SELECT COALESCE(SUM(like_count), 0) FROM kb_document
WHERE author_id = ? AND deleted = 0;

-- 查询用户总浏览量
SELECT COALESCE(SUM(view_count), 0) FROM kb_document
WHERE author_id = ? AND deleted = 0;
注意:使用 COALESCE(SUM(...), 0) 是为了处理用户没有发布文档的情况,确保返回 0 而非 NULL。

三、VO 设计

3.1 创建 UserStatisticsVO

创建 kb-user-auth/src/main/java/com/knowledge/base/userauth/vo/UserStatisticsVO.java:

package com.knowledge.base.userauth.vo;

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.io.Serializable;

/**
 * 用户统计响应VO
 *
 * <p>返回用户在知识库中的统计数据(文档数、浏览量、点赞数、评论数)</p>
 *
 * @author 苏三
 * @since 1.0.0
 */
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Schema(description = "用户统计数据")
public class UserStatisticsVO implements Serializable {

    private static final long serialVersionUID = 1L;

    @Schema(description = "文档数量", example = "12")
    private Long documentCount;

    @Schema(description = "总浏览量", example = "345")
    private Long viewCount;

    @Schema(description = "总获赞数", example = "89")
    private Long likeCount;

    @Schema(description = "总评论数", example = "23")
    private Long commentCount;
}

3.2 设计思路

  1. 使用 Lombok @Builder:便于在 Service 层通过 Builder 模式组装返回结果
  2. Long 类型:统计数据可能超过 Integer 范围,使用 Long 更安全
  3. 包含 commentCount:为后续扩展预留,当前评论数暂时返回 0L
  4. 独立 VO:统计数据来自跨库视图,与主表 kb_user 无直接关联,独立成 VO 避免耦合

四、数据访问层

4.1 更新 UserMapper.xml

remark 字段需要加入 MyBatis 的 resultMap 映射和基础列列表,同时新增三条统计查询 SQL。

修改 kb-user-auth/src/main/resources/mapper/UserMapper.xml:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.knowledge.base.userauth.mapper.UserMapper">

    <!-- 通用查询映射结果 -->
    <resultMap id="BaseResultMap" type="com.knowledge.base.userauth.entity.User">
        <id column="id" property="id" />
        <result column="username" property="username" />
        <result column="password" property="password" />
        <result column="email" property="email" />
        <result column="phone" property="phone" />
        <result column="avatar" property="avatar" />
        <result column="real_name" property="realName" />
        <result column="department" property="department" />
        <result column="position" property="position" />
        <result column="remark" property="remark" />       <!-- 新增 -->
        <result column="status" property="status" />
        <result column="last_login_time" property="lastLoginTime" />
        <result column="last_login_ip" property="lastLoginIp" />
        <result column="deleted" property="deleted" />
        <result column="create_time" property="createTime" />
        <result column="update_time" property="updateTime" />
        <result column="create_by" property="createBy" />
        <result column="update_by" property="updateBy" />
    </resultMap>
    <!-- 通用查询结果列 -->
    <sql id="Base_Column_List">
        id, username, password, email, phone, avatar, real_name, department, position,
        remark, status, last_login_time, last_login_ip, deleted,
        create_time, update_time, create_by, update_by
    </sql>
    <!-- 根据用户名查询用户 -->
    <select id="selectByUsername" resultMap="BaseResultMap">
        SELECT
        <include refid="Base_Column_List" />
        FROM kb_user
        WHERE username = #{username}
        AND deleted = 0
        LIMIT 1
    </select>
    <!-- 根据邮箱查询用户 -->
    <select id="selectByEmail" resultMap="BaseResultMap">
        SELECT
        <include refid="Base_Column_List" />
        FROM kb_user
        WHERE email = #{email}
        AND deleted = 0
        LIMIT 1
    </select>
    <!-- 根据手机号查询用户 -->
    <select id="selectByPhone" resultMap="BaseResultMap">
        SELECT
        <include refid="Base_Column_List" />
        FROM kb_user
        WHERE phone = #{phone}
        AND deleted = 0
        LIMIT 1
    </select>
    <!-- ==================== 新增统计查询 ==================== -->

    <!-- 统计用户文档数(跨库查询 kb_document 视图) -->
    <select id="countDocumentsByAuthorId" resultType="java.lang.Long">
        SELECT COUNT(*) FROM kb_document
        WHERE author_id = #{authorId} AND deleted = 0
    </select>
    <!-- 统计用户总获赞数(跨库查询 kb_document 视图) -->
    <select id="sumLikesByAuthorId" resultType="java.lang.Long">
        SELECT COALESCE(SUM(like_count), 0) FROM kb_document
        WHERE author_id = #{authorId} AND deleted = 0
    </select>
    <!-- 统计用户总浏览量(跨库查询 kb_document 视图) -->
    <select id="sumViewsByAuthorId" resultType="java.lang.Long">
        SELECT COALESCE(SUM(view_count), 0) FROM kb_document
        WHERE author_id = #{authorId} AND deleted = 0
    </select>
</mapper>

4.2 更新 UserMapper.java

在 Mapper 接口中新增三个统计方法声明。SQL 已在 XML 中定义,接口只需声明方法签名。

修改 kb-user-auth/src/main/java/com/knowledge/base/userauth/mapper/UserMapper.java,在现有方法后添加:

package com.knowledge.base.userauth.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.knowledge.base.userauth.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 用户Mapper接口
 *
 * @author 苏三
 * @since 1.0.0
 */
@Mapper
public interface UserMapper extends BaseMapper<User> {

    User selectByUsername(@Param("username") String username);
    User selectByEmail(@Param("email") String email);
    User selectByPhone(@Param("phone") String phone);
    int countUsers();

    // ==================== 新增方法 ====================

    /**
     * 统计用户文档数(查询 kb_document 跨库视图)
     *
     * @param authorId 作者ID
     * @return 文档数量
     */
    Long countDocumentsByAuthorId(@Param("authorId") Long authorId);

    /**
     * 统计用户总获赞数(查询 kb_document 跨库视图)
     *
     * @param authorId 作者ID
     * @return 总点赞数
     */
    Long sumLikesByAuthorId(@Param("authorId") Long authorId);

    /**
     * 统计用户总浏览量(查询 kb_document 跨库视图)
     *
     * @param authorId 作者ID
     * @return 总浏览量
     */
    Long sumViewsByAuthorId(@Param("authorId") Long authorId);
}

4.3 设计说明

  1. XML 映射优先:对于包含 COALESCE、SUM 等聚合函数的复杂查询,使用 XML 比 @Select 注解更易读、更易维护
  2. 跨库视图透明查询:Mapper 中直接写 FROM kb_document,MyBatis 运行时自动使用 kb_user 库中的同名视图,无需特殊处理
  3. NULL 安全:COALESCE(SUM(...), 0) 确保聚合查询在没有匹配行时返回 0,而非 NULL
  4. deleted = 0:所有查询都加上软删除条件,与项目统一逻辑一致

五、业务逻辑层

5.1 UserService 接口新增方法

在 UserService.java 中添加接口方法定义,同时新增 import:

// 新增 import
import com.knowledge.base.userauth.vo.UserStatisticsVO;

// 在 UserService 接口的末尾(最后一个 } 之前)新增以下方法:

/**
 * 获取用户统计数据(文档数、浏览量、点赞数、评论数)
 *
 * @param userId 用户ID
 * @return 用户统计数据
 */
UserStatisticsVO getUserStatistics(Long userId);

5.2 UserServiceImpl 新增实现

在 UserServiceImpl.java 中添加实现方法。先补充 import:

// 新增 import
import com.knowledge.base.userauth.vo.UserStatisticsVO;

在类的末尾(getUserPermissions 方法之后,类的 } 之前)添加实现:

@Override
public UserStatisticsVO getUserStatistics(Long userId) {
    log.info("获取用户统计数据:userId={}", userId);

    if (userId == null) {
        throw new BusinessException("用户ID不能为空");
    }

    // 检查用户是否存在
    User user = userMapper.selectById(userId);
    if (user == null) {
        throw new BusinessException(ResultCode.USER_NOT_EXIST);
    }

    // 分别查询各项统计数据
    Long docCount = userMapper.countDocumentsByAuthorId(userId);
    Long likeCount = userMapper.sumLikesByAuthorId(userId);
    Long viewCount = userMapper.sumViewsByAuthorId(userId);

    return UserStatisticsVO.builder()
            .documentCount(docCount != null ? docCount : 0L)
            .viewCount(viewCount != null ? viewCount : 0L)
            .likeCount(likeCount != null ? likeCount : 0L)
            .commentCount(0L)
            .build();
}

5.3 设计思路

  1. 参数校验:先检查 userId 是否为 null,再检查用户是否存在,双重保障
  2. 只调用一次 selectById:用户存在性检查只需查一次,统计查询本身不依赖主表数据
  3. null → 0L 转换:对每个返回值做了 null 保护。虽然 SQL 中已使用 COALESCE,但这里加一层防御性编程,防止 Mapper 方法返回 null
  4. Builder 模式:使用 Lombok 的 @Builder 清晰地设置各字段值
  5. commentCount = 0L:当前 kb_user 库中没有 kb_comment 视图,评论数暂时返回 0,作为预留字段

六、控制器层

6.1 新增 Controller 端点

在 UserController.java 中新增 GET /users/me/stats 端点。

先添加 import:

// 新增 import
import com.knowledge.base.common.utils.UserContextUtil;
import com.knowledge.base.userauth.vo.UserStatisticsVO;

在类的末尾(getUserPermissions 方法之后,类的 } 之前)添加:

/**
 * 获取当前登录用户的统计数据(文档数、浏览量、点赞数、评论数)
 *
 * @return 用户统计数据
 */
@GetMapping("/me/stats")
@Operation(summary = "获取当前用户统计数据",
        description = "获取当前登录用户的文档数、浏览量、点赞数、评论数")
public Result<UserStatisticsVO> getMyStatistics() {
    Long userId = UserContextUtil.getUserId();
    log.info("获取当前用户统计数据:userId={}", userId);

    UserStatisticsVO stats = userService.getUserStatistics(userId);
    return Result.success(stats);
}

6.2 API 端点清单

HTTP 方法URL 路径说明认证变更
GET/users/me/stats获取个人统计数据是新增
GET/users/{userId}查询用户详情是已有
PUT/users更新用户信息是已有
PUT/users/password/change修改密码是已有
PUT/users/{userId}/password/reset管理员重置密码是(管理员)已有

6.3 端点设计要点

  1. **路由路径 **/me/stats:/me/ 前缀语义明确,表示"与我相关的操作",放在 /users 基础路径下构成 /users/me/stats
  2. 认证方式:通过 UserContextUtil.getUserId() 从 JWT Token 中获取当前用户ID,确保用户只能查看自己的统计数据
  3. 返回格式:使用统一的 Result<UserStatisticsVO> 包装响应

七、前端实现

7.1 前端服务层说明

前端的 user.service.ts 中已有 getUserStats 方法,恰好调用了我们新增的后端端点:

// user.service.ts 中已存在的方法(无需修改)
getUserStats: (userId?: string) => {
    return http.get<{
        documentCount: number;
        viewCount: number;
        likeCount: number;
        commentCount: number;
    }>(userId ? `/auth/users/${userId}/stats` : '/auth/users/me/stats');
},

方法逻辑:

  • 不传 userId 时,调用 GET /auth/users/me/stats(即我们新增的端点)
  • 传 userId 时,调用 GET /auth/users/{userId}/stats(当前后端尚未实现,但为后续预留了接口)

7.2 修改 ProfilePage.tsx

个人中心页面的核心问题是"文档数"和"获赞数"显示为硬编码的 value={0}。需要进行三处修改:

**修改 1:引入 **useEffect** 和 **userService

// 修改前:
import React, { useState } from 'react';

// 修改后:
import React, { useState, useEffect } from 'react';
// 修改前:
import { useAuthStore } from '@/stores';
import { authService } from '@/services';

// 修改后:
import { useAuthStore } from '@/stores';
import { authService } from '@/services';
import { userService } from '@/services/user.service';

修改 2:添加状态和异步数据加载

// 在现有状态声明后添加:
const [avatarUrl, setAvatarUrl] = useState<string | undefined>(user?.avatar);
const [, setFileList] = useState<UploadFile[]>([]);

// ===== 新增 =====
// 用户统计数据状态
const [stats, setStats] = useState<{
  documentCount: number;
  viewCount: number;
  likeCount: number;
  commentCount: number;
} | null>(null);

// 组件挂载时加载统计数据
useEffect(() => {
  const fetchStats = async () => {
    try {
      const result = await userService.getUserStats();
      if (result) {
        setStats(result as {
          documentCount: number;
          viewCount: number;
          likeCount: number;
          commentCount: number;
        });
      }
    } catch {
      // 统计数据加载失败不影响页面使用,保持 null 状态
    }
  };
  if (user) {
    fetchStats();
  }
}, [user]);

修改 3:替换硬编码的统计数据

// 修改前:
<Row gutter={16}>
  <Col span={12}>
    <Statistic
      title="文档数"
      value={0}
      prefix={<UserOutlined />}
      valueStyle={{ color: '#1890ff' }}
    />
  </Col>
  <Col span={12}>
    <Statistic
      title="获赞数"
      value={0}
      prefix={<UserOutlined />}
      valueStyle={{ color: '#52c41a' }}
    />
  </Col>
</Row>
// 修改后:
<Row gutter={16}>
  <Col span={12}>
    <Statistic
      title="文档数"
      value={stats?.documentCount ?? 0}
      prefix={<UserOutlined />}
      valueStyle={{ color: '#1890ff' }}
    />
  </Col>
  <Col span={12}>
    <Statistic
      title="获赞数"
      value={stats?.likeCount ?? 0}
      prefix={<UserOutlined />}
      valueStyle={{ color: '#52c41a' }}
    />
  </Col>
</Row>

7.3 前端变更说明

变更点修改前修改后
文档数value={0} 硬编码value={stats?.documentCount ?? 0} 从后端API获取
获赞数value={0} 硬编码value={stats?.likeCount ?? 0} 从后端API获取
数据获取无useEffect 在组件挂载时调用 userService.getUserStats()
导入依赖useStateuseState, useEffect + userService
容错处理无catch 静默处理,保持页面可用

7.4 types/index.ts 类型说明

检查 types/index.ts 中的 User 接口:

export interface User {
  id: string | number;
  username: string;
  nickname?: string;
  realName?: string;
  email: string;
  phone?: string;
  avatar?: string;
  gender?: number;
  status: number | 'active' | 'inactive';
  remark?: string;        // ← 确保有此字段
  department?: string;
  position?: string;
  role?: string;
  createTime?: string;
  updateTime?: string;
  lastLoginTime?: string;
  lastLoginIp?: string;
}

当前 User 接口已包含 remark 字段,无需修改。


八、测试

8.1 数据库验证

# 1. 确认视图已创建
mysql -u root -p -e "USE kb_user; SHOW FULL TABLES WHERE Table_type = 'VIEW';"

# 预期输出:
# +------------------+------------+
# | Tables_in_kb_user | Table_type |
# +------------------+------------+
# | kb_document      | VIEW       |
# +------------------+------------+

# 2. 测试跨库查询
mysql -u root -p -e "USE kb_user; SELECT COUNT(*) AS cnt FROM kb_document WHERE deleted = 0;"

# 3. 测试统计查询
mysql -u root -p -e "
USE kb_user;
SELECT
    (SELECT COUNT(*) FROM kb_document WHERE author_id = 1 AND deleted = 0) AS doc_count,
    (SELECT COALESCE(SUM(like_count), 0) FROM kb_document WHERE author_id = 1 AND deleted = 0) AS likes,
    (SELECT COALESCE(SUM(view_count), 0) FROM kb_document WHERE author_id = 1 AND deleted = 0) AS views;
"

8.2 测试页面功能

按顺序启动下面这些微服务:

kb-gateway

kb-auth

启动前端

cd knowledge-base-frontend

npm run dev

浏览器访问个人中心页面:

http://localhost:3002/profile

图片.png

这个页面可以修改个人头像、修改个人信息、也可以修改密码。

当前登录账号所关联的文档数和获赞数。

总结

11.1 已实现功能

序号功能状态
1数据库添加 remark 列✅
2创建 kb_document 跨库视图✅
3UserStatisticsVO 用户统计响应 VO✅
4UserMapper.xml 新增 remark 映射✅
5UserMapper.xml 新增 3 条统计查询 SQL✅
6UserMapper.java 新增 3 个统计方法✅
7UserService.getUserStatistics() 接口定义✅
8UserServiceImpl.getUserStatistics() 实现✅
9GET /users/me/stats 控制器端点✅
10ProfilePage.tsx 动态加载统计数据✅

11.2 技术要点

  1. 跨库视图:通过 MySQL CREATE VIEW 实现跨库透明查询,避免服务间 HTTP 调用的复杂性
  2. SQL 在 XML 中定义:聚合查询使用 XML 映射而非 @Select 注解,提高 SQL 可读性和维护性
  3. COALESCE 处理 NULL:COALESCE(SUM(...), 0) 确保无数据时返回 0,非 NULL
  4. 双重 null 保护:SQL 层使用 COALESCE,Java 层再做 null → 0L 转换,防御性编程
  5. Builder 模式:使用 @Builder 构建 VO 对象,代码清晰易读
  6. 容错降级:前端统计数据加载失败不影响页面主功能,静默降级为 0
最后修改:2026 年 10 月 24 日
如果觉得我的文章对你有用,请随意赞赏