day1-神领物流项目（微服务架构实战）环境搭建与团队协作

1. 神领物流项目环境搭建全攻略第一次接触神领物流这种企业级微服务项目时我被复杂的开发环境配置折腾得够呛。记得当时为了跑通一个运费计算接口整整花了两天时间搭建环境。现在我把这些经验整理成保姆级教程帮你避开我踩过的那些坑。这个物流系统采用典型的微服务架构包含用户端小程序、快递员APP、司机APP和管理后台四个终端。技术栈相当丰富基础框架SpringCloud Hoxton SpringBoot 2.2.5中间件全家桶Nacos、RabbitMQ、Redis、Neo4j等特色组件美团Leaf生成分布式ID、Skywalking做链路追踪开发环境准备有三个关键点JDK版本必须使用JDK11建议用Amazon Corretto版本Maven配置需要配置私服地址这个后面会详细说明虚拟机环境项目提供的CentOS7镜像已经预装所有中间件# 检查JDK版本 java -version # 应该显示类似以下信息 openjdk version 11.0.15 2022-04-19 OpenJDK Runtime Environment Corretto-11.0.15.9.1 (build 11.0.159-LTS) OpenJDK 64-Bit Server VM Corretto-11.0.15.9.1 (build 11.0.159-LTS, mixed mode)2. 团队协作模式解析在实际开发中我们5人后端团队是这样分工协作的2.1 代码管理方案使用Gogs搭建的内部Git服务每个微服务都是独立仓库。新人入职时只需要克隆自己负责的仓库比如我负责的运费计算服务git clone http://git.sl-express.com/sl-express/sl-express-ms-freight.git这种设计有三个好处避免新人误改其他模块代码编译时不会受其他服务错误影响更符合微服务独立开发部署的理念2.2 依赖管理技巧项目采用Maven私服管理内部依赖需要在settings.xml配置mirrors mirror idsl-mirror/id mirrorOfcentral,!sl-releases,!sl-snapshots/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors私服中存放着两类重要依赖parent工程统一管理所有子模块的依赖版本common包包含权限校验、日志工具等公共代码3. 微服务架构实战要点3.1 网关层设计所有请求都经过API网关这里实现了关键的安全控制// 管理端过滤器示例 public class ManagerTokenGatewayFilter implements AuthFilter { Override public Boolean auth(String token, AuthUserInfoDTO userInfo) { // 获取用户角色 ListLong userRoles authTemplate.opsForRole() .findRoleByUserId(userInfo.getUserId()) .getData(); // 校验是否包含管理员角色 return CollUtil.containsAny(userRoles, managerRoleIds); } }四个终端对应的路由规则用户端/customer/**快递员端/courier/**司机端/driver/**管理端/manager/**3.2 配置管理方案使用Nacos作为配置中心动态管理各类参数。比如运费计算规则这样配置# sl-express-ms-freight.properties freight.rule.base10 freight.rule.perKg2 freight.rule.discount0.9开发中最常改的三个配置数据库连接池参数Redis缓存过期时间消息队列重试次数4. 开发调试技巧4.1 本地环境配置建议使用IDEA的Run Configuration功能为每个微服务创建独立的启动配置。关键参数VM options-Dspring.profiles.activedevEnvironment variablesNACOS_SERVER192.168.150.101:88484.2 联调测试方法当需要测试微服务间调用时可以用Postman构造请求POST http://localhost:9527/manager/order/create Authorization: Bearer xxxx.yyyy.zzzz Content-Type: application/json { senderAddress: 北京市海淀区, receiverAddress: 上海市浦东新区, weight: 3.5 }常见问题排查步骤检查Nacos服务列表确认目标服务在线查看网关日志确认请求路由正确通过Skywalking追踪完整调用链路5. 持续集成实践公司的Jenkins流水线会自动完成代码质量检查SonarQube单元测试执行Docker镜像构建测试环境部署部署一个微服务的典型日志[Pipeline] sh docker build -t sl-express/sl-express-ms-freight:1.1.0 . [Pipeline] sh docker push sl-express/sl-express-ms-freight:1.1.0 [Pipeline] sh kubectl rollout restart deployment sl-express-ms-freight对于刚接触微服务的新人建议先从运费计算这种相对独立的服务入手。我在开发第一个功能时先把整个调用链路图画出来标注清楚每个环节的输入输出这样调试时就能快速定位问题环节。