docsify-jsonrpc/zh-cn/service_splitting.md

服务拆分

项目拆分为 公共服务 和 对外接口服务：主要逻辑提供对外接口服务，公共服务提供基础服务（如微信接口服务、权限服务、用户服务等）。

为什么要拆分？

1. 提高可维护性：拆分为较小服务（公共服务、对外接口服务等）使代码库清晰易管理，每个服务职责明确，减少复杂度，便于维护和更新。
2. 增强扩展性：服务可独立扩容，例如微信接口服务负载增加时可单独扩容，而不影响其他服务。
3. 简化部署过程：小型服务更易于部署，可更快发布新功能和修复 bug，降低整体风险。
4. 提升容错能力：服务隔离，一个服务出错不会轻易影响其他服务。
5. 促进团队协作：不同团队/成员可专注于不同服务并行开发，效率更高，也可选择最合适的技术栈。
6. 优化资源利用：按服务需求分配资源（CPU/内存），提高资源利用率，降低成本。

---

整体架构图

使用时序图直观展示服务拆分与通信关系：

sequenceDiagram
    participant Client as HTTP API 接口
    participant User as 用户服务
    participant Perm as 权限服务
    participant WeChat as 微信服务
    participant Nacos as 注册中心

    Client->>User: JSON-RPC 请求
    Client->>Perm: JSON-RPC 请求
    Client->>WeChat: JSON-RPC 请求

    loop 服务注册/发现
        User->>Nacos: 注册/发现
        Perm->>Nacos: 注册/发现
        WeChat->>Nacos: 注册/发现
    end

    Note right of Nacos: 管理服务注册<br/>和健康检查

    User-->>Client: 返回用户数据
    Perm-->>Client: 返回权限数据
    WeChat-->>Client: 返回微信数据

---

核心组件说明

组件	作用
Nacos	服务注册与发现中心，管理服务实例和健康检查
JSON-RPC	轻量级服务间通信协议，结构清晰，跨语言调用友好
Hyperf	高性能协程框架，提供 RPC 客户端/服务端及服务治理能力

---

实现步骤详解

1️⃣ 安装依赖

composer require hyperf/json-rpc
composer require hyperf/rpc-server

---

2️⃣ 启动 Nacos 服务注册中心

可使用 Docker 快速启动：

docker run -d -p 8848:8848 --name nacos nacos/nacos-server
# 访问 http://localhost:8848/nacos 查看服务注册情况

---

3️⃣ 创建服务提供者

定义接口（Interface）

// app/Service/UserServiceInterface.php
namespace App\Service;

interface UserServiceInterface
{
    public function getUserById(int $id): array;
}

实现接口逻辑

// app/Service/Impl/UserServiceImpl.php
namespace App\Service\Impl;

use App\Service\UserServiceInterface;

class UserServiceImpl implements UserServiceInterface
{
    public function getUserById(int $id): array
    {
        // 模拟数据库查询
        return ['id' => $id, 'name' => '张三'];
    }
}

---

服务注册与发现流程

1. 公共服务启动后，通过 JsonRpcServer 在指定端口监听；
2. 并向 Nacos 注册服务名（如 App\Service\UserServiceInterface）和地址；
3. 对外接口服务启动后，从 Nacos 获取所需服务地址；
4. 通过 Hyperf 内置 JSON-RPC 客户端 调用远程方法；
5. 调用过程自动完成 JSON-RPC 协议序列化/反序列化；
6. 内置支持负载均衡（随机、轮询等）和容错（失败重试、熔断等）。

---