项目简介
本项目是基于Spring Cloud Alibaba技术栈的微服务模板项目,提供了快速启动和开发的微服务架构模板。项目涵盖多个模块,从配置文档到网关服务,助力开发者快速搭建与部署微服务应用。
项目的主要特性和功能
模块划分
- docs:配置文档模块,存放项目配置文档。
- boot:启动模块,负责项目启动与初始化。
- boot - dev:开发模块,提供开发环境配置与工具。
- boot - parent:依赖模块,管理项目依赖关系。
- gateway:网关服务模块,提供统一入口与路由功能。
- web - parent:Web服务模块,处理Web请求与响应。
- rest - parent:Rest服务模块,处理Restful API请求。
- service - parent:内部服务模块,提供内部服务与业务逻辑处理。
开发日志规范
- [+]:添加功能
- [-]:删除功能
- [*]:修改功能
- [!]:危险操作
- [#]:未完成
- [~]:日常任务
安全配置
- Web服务:用传统Session记录状态,通过RedisSession实现共享,需用户用拦截器或Spring Security实现认证授权。
- Session失效:Web登录成功访问未集成RedisSession的项目会致Session失效,可设置session的cookie.name、cookie.domain或cookie.path区分。
- Rest服务:用OAuth2服务通过网关实现统一认证鉴权。
- 测试:为方便测试后台接口,可绕过网关直接请求WWW(Web/Rest)服务,配置
system.rest.ignore - user=true
忽略用户拦截,模拟用户登陆需添加请求头部current - user
设置登陆用户信息。
配置管理
配置统一放于Nacos配置中心,通过bootstrap.yml
加载。
版本管理
通过Git和Maven进行版本管理,包含设置标签、版本号和批量修改部署脚本。
系统配置
涵盖系统名称、版本、机器编号、端口、序列化类型等众多配置项。
错误处理
系统统一处理所有异常错误,Web模块建议不使用网关进行地址截取,同时配置错误路径防止重定向跳转地址错误。
Maven配置
包含应用启动JVM参数、内存、作者、模块、项目根目录、编码、是否跳过打包等配置。
端口配置
明确各个模块(网关、Rest OAuth2、Web、Rest等)的端口范围。
开发规范
服务实例业务逻辑供测试用,可按需修改删除。有配置、过滤器等的命名规范。
JDK17
Dubbo暂不支持JDK17,启动需添加特定参数。
安装使用步骤
- 复制项目:略(原文未提供命令)
- 配置Nacos:在
bootstrap.yml
中配置Nacos连接信息,如用户名、密码、命名空间、服务器地址等。 - 启动Nacos:确保Nacos服务已启动并运行。
- 启动各个模块:按模块依赖关系,依次启动
boot
、gateway
、web - parent
、rest - parent
、service - parent
等模块。 - 测试服务:用Postman或其他API测试工具,测试各服务接口,确保服务正常运行。
- 部署:按需将各模块部署到相应服务器,确保服务高可用性与稳定性。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】