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

数据流说明:
- 读路径:
ProfilePage加载 →GET /auth/me获取用户信息 →GET /users/me/stats获取统计数据 → 渲染页面 - 写路径:表单提交 →
PUT /users/profile更新用户资料 → 刷新页面状态 - 统计查询:从
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 设计思路
- 使用 Lombok @Builder:便于在 Service 层通过 Builder 模式组装返回结果
- Long 类型:统计数据可能超过 Integer 范围,使用 Long 更安全
- 包含 commentCount:为后续扩展预留,当前评论数暂时返回 0L
- 独立 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 设计说明
- XML 映射优先:对于包含
COALESCE、SUM等聚合函数的复杂查询,使用 XML 比@Select注解更易读、更易维护 - 跨库视图透明查询:Mapper 中直接写
FROM kb_document,MyBatis 运行时自动使用kb_user库中的同名视图,无需特殊处理 - NULL 安全:
COALESCE(SUM(...), 0)确保聚合查询在没有匹配行时返回 0,而非 NULL - 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 设计思路
- 参数校验:先检查 userId 是否为 null,再检查用户是否存在,双重保障
- 只调用一次 selectById:用户存在性检查只需查一次,统计查询本身不依赖主表数据
- null → 0L 转换:对每个返回值做了 null 保护。虽然 SQL 中已使用
COALESCE,但这里加一层防御性编程,防止 Mapper 方法返回 null - Builder 模式:使用 Lombok 的
@Builder清晰地设置各字段值 - 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 端点设计要点
- **路由路径 **
/me/stats:/me/前缀语义明确,表示"与我相关的操作",放在/users基础路径下构成/users/me/stats - 认证方式:通过
UserContextUtil.getUserId()从 JWT Token 中获取当前用户ID,确保用户只能查看自己的统计数据 - 返回格式:使用统一的
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() |
| 导入依赖 | useState | useState, 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
浏览器访问个人中心页面:

这个页面可以修改个人头像、修改个人信息、也可以修改密码。
当前登录账号所关联的文档数和获赞数。
总结
11.1 已实现功能
| 序号 | 功能 | 状态 |
|---|---|---|
| 1 | 数据库添加 remark 列 | ✅ |
| 2 | 创建 kb_document 跨库视图 | ✅ |
| 3 | UserStatisticsVO 用户统计响应 VO | ✅ |
| 4 | UserMapper.xml 新增 remark 映射 | ✅ |
| 5 | UserMapper.xml 新增 3 条统计查询 SQL | ✅ |
| 6 | UserMapper.java 新增 3 个统计方法 | ✅ |
| 7 | UserService.getUserStatistics() 接口定义 | ✅ |
| 8 | UserServiceImpl.getUserStatistics() 实现 | ✅ |
| 9 | GET /users/me/stats 控制器端点 | ✅ |
| 10 | ProfilePage.tsx 动态加载统计数据 | ✅ |
11.2 技术要点
- 跨库视图:通过 MySQL CREATE VIEW 实现跨库透明查询,避免服务间 HTTP 调用的复杂性
- SQL 在 XML 中定义:聚合查询使用 XML 映射而非
@Select注解,提高 SQL 可读性和维护性 - COALESCE 处理 NULL:
COALESCE(SUM(...), 0)确保无数据时返回 0,非 NULL - 双重 null 保护:SQL 层使用 COALESCE,Java 层再做 null → 0L 转换,防御性编程
- Builder 模式:使用
@Builder构建 VO 对象,代码清晰易读 - 容错降级:前端统计数据加载失败不影响页面主功能,静默降级为 0