基于 SpringBoot + Dubbo 微服务架构的企业知识库管理系统。
历史部分有点问题。
- Spring Boot 2.7.18
- Apache Dubbo 3.2.0（RPC框架）
- MyBatis Plus 3.5.3.1
- MySQL 8.0
- ElasticSearch 7.17.9
- Redis
- Nacos 2.2.3（服务注册与发现）
- Vue 3
- Element Plus
- Vite
- Axios
┌─────────────────┐
│ gateway-service │ (API 网关，端口 8080)
└────────┬────────┘
│ Dubbo RPC 调用
├─────────────┬──────────────┬─────────────┬─────────────┐
│ │ │ │ │
┌────▼────┐ ┌────▼────┐ ┌─────▼─────┐ ┌───▼────┐ ┌─────▼─────┐
│ user- │ │ file- │ │knowledge- │ │search- │ │ audit- │
│ service │ │ service │ │ service │ │service │ │ service │
│ 8085 │ │ 8081 │ │ 8082 │ │ 8083 │ │ 8084 │
└─────────┘ └─────────┘ └───────────┘ └────────┘ └───────────┘
│ │ │ │ │
└─────────────┴──────────────┴─────────────┴─────────────┘
│
┌────────▼────────┐
│ Nacos Registry │
│ (端口 8848) │
└─────────────────┘
# 在项目根目录执行（WSL 环境）
cd /mnt/c/Users/ZeroHzzzz/Desktop/java
# 启动所有基础服务（MySQL、Redis、ElasticSearch、Nacos、kkFileView）
sudo docker compose up -d
# 等待服务启动（约 30-60 秒）
# 验证 Nacos：访问 http://localhost:8848/nacos (用户名/密码: nacos/nacos)
# 验证 kkFileView：访问 http://localhost:8012 (文件预览服务)注意：
- 数据库会在首次启动时自动初始化（通过
docker-compose.yml配置） - kkFileView 文件预览服务会自动启动，默认端口 8012
- 如果修改了 kkFileView 端口，需要在
frontend/.env中配置VITE_KKFILEVIEW_URL
如果需要测试数据，执行以下命令：
# 导入测试数据（测试账号、测试知识等）
sudo docker exec -i knowledge-mysql mysql -uroot -proot knowledge_db < sql/test_data.sql# 进入后端目录
cd backend
# 使用启动脚本（会自动编译并启动所有服务）
bash start.sh# 1. 编译项目
cd backend
mvn clean install -DskipTests
# 2. 按顺序启动各个服务（每个服务需要独立的终端）
cd user-service && mvn spring-boot:run
cd file-service && mvn spring-boot:run
cd knowledge-service && mvn spring-boot:run
cd search-service && mvn spring-boot:run
cd audit-service && mvn spring-boot:run
cd gateway-service && mvn spring-boot:run # 最后启动启动顺序很重要：gateway-service 必须最后启动，因为它依赖其他服务。
cd frontend
npm install
npm run dev| 服务 | HTTP 端口 | Dubbo 端口 | 说明 |
|---|---|---|---|
| gateway-service | 8080 | 20880 | API 网关 |
| file-service | 8081 | 20881 | 文件服务 |
| knowledge-service | 8082 | 20882 | 知识服务 |
| search-service | 8083 | 20883 | 搜索服务 |
| audit-service | 8084 | 20884 | 审核服务 |
| user-service | 8085 | 20885 | 用户服务 |
访问：http://localhost:8848/nacos
- 在"服务管理" → "服务列表"中应该能看到所有 6 个服务
# 测试网关服务
curl http://localhost:8080/api/knowledge/list# 如果使用启动脚本，日志在 logs/ 目录
tail -f backend/logs/gateway-service.log# 停止微服务
cd backend
bash stop.sh
# 停止基础服务（Docker）
sudo docker compose down如果 Nacos 出现数据库相关错误，使用修复脚本：
bash docker/fix-nacos-database.sh- 检查 Nacos 是否正常运行：
curl http://localhost:8848/nacos/ - 检查配置文件中的 Nacos 地址是否正确（默认：
localhost:8848） - 查看服务日志
# 查看端口占用
sudo netstat -tulpn | grep 8080
# 停止占用端口的进程
sudo kill <PID>所有测试账号的默认密码都是：password123
| 用户名 | 密码 | 角色 | 部门 | 权限说明 |
|---|---|---|---|---|
admin |
password123 | ADMIN | IT部门 | 总管理员，拥有所有权限（审核、用户管理等） |
editor1 |
password123 | EDITOR | 业务部 | 知识管理员，可以上传、编辑知识，提交审核 |
editor2 |
password123 | EDITOR | 技术部 | 同上 |
editor3 |
password123 | EDITOR | 客户服务部 | 同上 |
user1 ~ user5 |
password123 | USER | 各业务部门 | 普通员工，只能查看、搜索、下载已发布的知识 |
角色说明：
- ADMIN（总管理员）：负责审核知识、管理用户、系统配置
- EDITOR（知识管理员）：负责本部门知识的收集、整理和上传
- USER（普通员工）：使用知识库进行学习和工作
⚠️ 注意：生产环境必须修改所有默认密码！
- 部署指南 - 完整的部署说明和常见问题
java/
├── backend/ # 后端微服务
│ ├── gateway-service/ # API 网关
│ ├── user-service/ # 用户服务
│ ├── file-service/ # 文件服务
│ ├── knowledge-service/# 知识服务
│ ├── search-service/ # 搜索服务
│ ├── audit-service/ # 审核服务
│ ├── knowledge-api/ # API 接口定义
│ ├── knowledge-common/ # 公共模块
│ ├── start.sh # 启动脚本
│ └── stop.sh # 停止脚本
│
├── frontend/ # 前端代码
├── docker/ # Docker 相关脚本
├── sql/ # 数据库脚本
├── docs/ # 项目文档
└── docker-compose.yml # Docker Compose 配置
MIT License