Spring Boot 4 部署与运行说明

适用范围

本文档适用于 joolun-plus 2.0.7 的 Spring Boot 4 运行环境。

当前后台包含以下 10 个服务：

1. joolun-auth
2. joolun-upms-admin
3. joolun-gateway
4. joolun-monitor
5. joolun-codegen
6. joolun-weixin-admin
7. joolun-mall-admin
8. joolun-mall-api
9. joolun-pay-admin
10. joolun-live-admin

当前 plus 基础框架不包含 supplier 与 open_* 服务。

运行基线

• JDK 17 LTS
• Spring Boot 4.0.7
• Spring Cloud 2025.1.2
• Spring Cloud Alibaba 2025.1.0.0
• Nacos 3.1.1
• RocketMQ 5.3.2
• 支付服务名称为 joolun-pay-admin

数据库基线

• Nacos 配置库为 joolun_plus_config，表结构与 Nacos 3.1.1 一致
• 基础权限库为 joolun_plus_upms
• 商城业务库为 joolun_plus_mall
• 微信业务库为 joolun_plus_wx
• 代码生成器使用 joolun_plus_codegen
• sys_oauth_client 中存在 internal-service
• internal-service 授权方式包含 client_credentials
• 支付菜单权限前缀和网关路由统一使用 pay

Nacos 基线

本地开发 hosts 示例

127.0.0.1 joolun-plus-nacos
127.0.0.1 joolun-plus-gateway
192.168.31.100 joolun-plus-redis
192.168.31.100 joolun-plus-mysql

Nacos 控制台地址为 http://joolun-plus-nacos:8848/nacos。

配置中心包含以下 Data ID：

• application-dev.yml
• dynamic_routes
• joolun-auth-dev.yml
• joolun-gateway-dev.yml
• joolun-upms-admin-dev.yml
• joolun-monitor-dev.yml
• joolun-codegen-dev.yml
• joolun-weixin-admin-dev.yml
• joolun-mall-admin-dev.yml
• joolun-mall-api-dev.yml
• joolun-pay-admin-dev.yml
• joolun-live-admin-dev.yml

所有服务通过 spring.config.import 加载 Nacos 配置。公共配置由所有服务共享，数据源基线如下：

spring:
  datasource:
    dynamic:
      lazy: false
      hikari:
        minimum-idle: 0
        maximum-pool-size: 20
        idle-timeout: 60000
    sharding:
      minimum-idle: 0
      idle-timeout: 60000
      lazy: true

内部调用配置 security.oauth2.client.inside.* 只放在所有服务都会加载的公共配置中。内部 Feign 调用仅使用 internal-service OAuth2 客户端。

路由基线

• joolun-pay-admin 的网关前缀为 /pay/**
• dynamic_routes 覆盖当前 10 个后台服务
• 网关路由目标与各服务的 spring.application.name 保持一致
• 当前环境不配置 supplier 与 open_* 路由

启动规则

1. 基础中间件：MySQL、Redis、Elasticsearch、RocketMQ、Nacos
2. 核心服务：joolun-auth、joolun-upms-admin、joolun-gateway
3. 平台服务：joolun-monitor、joolun-codegen
4. 业务服务：joolun-weixin-admin、joolun-mall-admin、joolun-mall-api、joolun-pay-admin、joolun-live-admin

运行验收

• 10 个服务全部注册到 Nacos
• 后台登录、菜单、权限和用户信息接口运行正常
• /v3/api-docs/swagger-config 可正常访问
• 网关转发常用接口无 404、无 5xx
• 服务间 Feign 调用使用 internal-service token
• 数据库连接总数符合连接容量预算
• codegen 可以连接数据库
• mall-admin、mall-api 常用接口运行正常
• /pay/** 路由和 pay: 权限前缀运行正常
• live 模块运行正常

运行检查

Nacos 配置未加载

• 检查服务的 spring.config.import
• 检查 Nacos 中对应 Data ID、命名空间和分组
• 检查服务名与配置文件名是否一致

商城自动配置未加载

• 检查 joolun-mall-common 是否在依赖树中
• 检查 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
• 检查 upms 与商城公共模块的版本是否一致

数据库连接数超出预算

• 检查公共配置中的 Hikari 参数
• 检查 YAML Provider 是否单独负责创建 master
• 检查 JDBC Provider 是否只加载扩展数据源
• 检查动态租户库是否使用 minimum-idle: 0 与 lazy: true