环境准备与运行指南
前言
本文档面向开发人员，介绍 PointLion Cloud 微服务版本的环境要求、服务启动顺序、开发调试等内容。
使用前准备
环境要求
必需组件
- Nacos Server (2.x+) - 服务注册与配置中心
- MySQL (5.7+) - 关系型数据库（需配置忽略大小写：
lower_case_table_names=1） - Redis (6.x+) - 缓存中间件
- RocketMQ (5.x+) - 消息队列（必选）
可选组件
- Sentinel Dashboard - 流量控制监控台
- XXL-Job Admin - 定时任务管理
- SkyWalking - 链路追踪系统
- ELK Stack - 日志分析系统
启动顺序
重要：必须按照以下顺序启动服务，否则会导致服务依赖问题
基础设施层
bash# 1. 启动 Nacos cd nacos/bin ./startup.sh -m standalone # 2. 启动 Redis redis-server # 3. 启动 MySQL systemctl start mysql核心服务层
bash# 4. 启动网关服务 cd pointlion-gateway mvn spring-boot:run # 5. 启动系统服务（必须） cd pointlion-module-system/pointlion-module-system-server mvn spring-boot:run业务服务层
bash# 6. 启动其他业务服务（按需启动） cd pointlion-module-oa/pointlion-module-oa-server mvn spring-boot:run cd pointlion-module-am/pointlion-module-am-server mvn spring-boot:run前端应用
bash# 7. 启动前端 cd pointlion-cloud-ui npm install npm run dev
服务端口分配
| 服务名称 | 端口 | 说明 |
|---|---|---|
| Gateway | 8080 | API 网关统一入口 |
| System-Server | 8081 | 系统管理服务 |
| OA-Server | 8082 | 办公自动化服务 |
| AM-Server | 8083 | 资产管理服务 |
| CRM-Server | 8084 | 客户关系管理服务 |
| HRM-Server | 8085 | 人力资源管理服务 |
| ERP-Server | 8086 | 企业资源计划服务 |
| Workflow-Server | 8087 | 工作流服务 |
| Mall-Server | 8088 | 商城服务 |
| IoT-Server | 8089 | 物联网服务 |
| Nacos | 8848 | 注册中心与配置中心 |
| Sentinel-Dashboard | 8858 | 流量控制台 |
| XXL-Job-Admin | 8888 | 定时任务管理 |
访问地址
本地开发环境
- 前端应用: http://localhost:3000
- API 网关: http://localhost:8080
- Nacos 控制台: http://localhost:8848/nacos (默认账号密码: nacos/nacos)
- Sentinel 控制台: http://localhost:8858
- XXL-Job 控制台: http://localhost:8888/xxl-job-admin (默认账号密码: admin/123456)
API 文档
- 系统模块: http://localhost:8080/system/doc.html
- OA 模块: http://localhost:8080/oa/doc.html
- AM 模块: http://localhost:8080/am/doc.html
- Workflow 模块: http://localhost:8080/workflow/doc.html
默认账号
超级管理员
- 账号: admin
- 密码: admin123
⚠️ 重要提示：首次登录后请立即修改密码！
常见操作
如何查看服务状态
方式一：通过 Nacos 控制台
- 访问 http://localhost:8848/nacos
- 登录后进入「服务管理 → 服务列表」
- 查看所有已注册的服务及其健康状态
方式二：通过 Gateway 查看路由
bash
curl http://localhost:8080/actuator/gateway/routes如何动态刷新配置
当修改 Nacos 配置后，可通过以下方式刷新：
方式一：通过 Actuator 端点
bash
curl -X POST http://localhost:8081/actuator/refresh方式二：通过 Nacos 控制台
- 进入「配置管理 → 配置列表」
- 找到对应配置
- 点击「编辑」并发布
- 配置会自动推送到服务（需配置监听器）
如何排查服务启动失败
检查日志文件
bashtail -f logs/pointlion-cloud.log检查端口占用
bash# Windows netstat -ano | findstr :8080 # Linux/Mac lsof -i :8080检查 Nacos 连接
- 确认 Nacos 是否已启动
- 检查配置文件中的 Nacos 地址是否正确
- 查看 Nacos 控制台的服务注册情况
检查数据库连接
- 确认 MySQL 是否已启动
- 检查数据库配置是否正确
- 验证数据库用户权限
检查依赖服务
- 某些服务依赖其他服务，必须按顺序启动
- 例如：所有业务服务都依赖 System 服务
模块依赖关系
┌─────────────┐
│ Gateway │
└──────┬──────┘
│
┌────────────────┼────────────────┐
│ │ │
┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐
│ System │───→│ Infra │ │ Workflow │
│ (必选) │ │ (可选) │ │ (可选) │
└─────┬─────┘ └───────────┘ └───────────┘
│
┌─────┼──────────────────────────────────┐
│ │ │
┌───▼──┐ ┌─▼───┐ ┌──▼──┐ ┌──▼──┐ ┌───▼──┐ ┌──▼──┐
│ OA │ │ AM │ │ CRM │ │ HRM │ │ ERP │ │ Mall │
└──────┘ └─────┘ └─────┘ └─────┘ └──────┘ └─────┘说明：
- Gateway：所有外部请求的统一入口
- System：系统核心服务，提供用户、权限等基础功能，所有业务服务都依赖它
- Infra：基础设施服务，提供文件、代码生成等功能，可选依赖
- Workflow：工作流服务，OA、AM 等模块的审批功能依赖它
日志级别调整
在 Nacos 配置中心修改日志级别：
yaml
logging:
level:
root: INFO
com.pointlion: DEBUG
org.springframework: INFO性能优化建议
1. 缓存优化
- 启用 Redis 缓存热点数据
- 合理设置缓存过期时间
- 使用本地缓存减少网络开销
2. 数据库优化
- 定期分析慢查询日志
- 优化索引设计
- 使用读写分离
3. JVM 优化
- 根据业务特点调整堆内存大小
- 选择合适的垃圾收集器
- 监控 GC 频率
4. 服务调优
- 配置合理的线程池大小
- 启用连接池监控
- 使用 Sentinel 限流保护
安全建议
1. 密码安全
- 修改默认管理员密码
- 使用强密码策略
- 定期更换密码
2. 网络安全
- 生产环境使用 HTTPS
- 配置防火墙规则
- 限制管理端口访问
3. 数据安全
- 定期备份数据库
- 启用操作日志审计
- 敏感数据加密存储
技术支持
如遇到问题，请通过以下方式获取帮助：
- 官网: www.dianshixinxi.com
- Issue: 在代码仓库提交问题
- 邮箱: 439635374@qq.com
💡 提示：如需了解各模块的使用方法，请查看 使用手册