Webman单体拆微服务核心卡点是数据边界、调用链路和部署粒度；必须按业务域（非技术层）切分，用DDD识别有界上下文，代码隔离+独立数据库+Consul+Guzzle+Kong网关+Docker镜像规范缺一不可。
Webman 单体项目直接拆成微服务，不是换个框架或加个注册中心就能跑通的。核心卡点在数据边界、调用链路和部署粒度——不解决这三点，拆出来的是“分布式单体”，不是微服务。
Webman 服务拆分必须按业务域切，不能按技术层切
很多人把 Webman 的 app/controller、app/model、app/service 直接挪到不同服务里，结果各服务仍共用一个数据库、共享 Eloquent 模型、互相调用 UserService::getById() 这类内部方法。这本质是物理拆分、逻辑未解耦。
- 正确做法：先用 DDD 思维识别有界上下文，比如“用户注册”和“订单创建”必须属于不同上下文，它们的数据表、状态机、校验规则互不感知
- Webman 项目中要先做代码隔离：删除跨模块的
use App\Service\OrderService，改用 HTTP 或消息队列通信 - 每个新服务（如
user-service）必须自带migrations和seeds，禁止从原单体库中SELECT * FROM users - 拆分后第一个上线的服务建议选“通知服务”或“文件上传服务”——它们依赖少、无状态、易验证，能快速建立团队对微服务交付节奏的信心
Consul 注册 + Guzzle 调用是最小可行组合
Webman 本身无内置服务发现能力，强行接入 Nacos 或 Eureka 会引入 Java 生态依赖和运维复杂度。2026 年 PHP 微服务生产环境最稳的轻量方案仍是 Consul + 原生 HTTP 调用。
- 服务启动时向 Consul 发送 PUT 请求注册：
curl -X PUT http://consul:8500/v1/agent/service/register -d '{"name":"user-service","address":"10.0.1.22","port":8787}' - 调用方不硬编码 IP，改用 Consul DNS：
$client->get('http://user-service.service.consul:8787/api/users/123') - Guzzle 必须配置超时与重试：
'timeout' => 3.0, 'connect_timeout' => 1.5, 'http_errors' => false，否则一个服务抖动会导致整个请求链雪崩 - 禁止在 Webman 控制器里写
new UserClient()这种紧耦合调用；应通过容器绑定接口，例如$this->app->bind(UserClientInterface::class, UserClient::class)
API 网关必须接管鉴权，服务内部禁用 JWT 验证
Webman 单体里常见的 AuthMiddleware 如果照搬到每个微服务中，会导致 Token 校验重复执行、密钥分散管理、权限策略不一致。网关才是唯一可信入口。
立即学习“PHP免费学习笔记（深入）”；
- Kong 是当前 Webman 微服务生态最适配的网关：它支持 JWT 插件自动解析
Authorization头，并将consumer_id、user_id透传到后端X-Consumer-ID、X-User-ID头 - 所有 Webman 微服务的中间件里，删掉所有
JWTAuth::parseToken()、Auth::check()类逻辑，只信任网关透传的头信息 - 网关配置示例（Kong Admin API）：
curl -X POST http://kong:8001/services/user-service/routes --data "paths[]=/api/users" --data "strip_path=true" - 若用 Traefik，需配合 ForwardAuth 中间件做统一鉴权，避免在每个服务里重复实现登录态校验
Docker 镜像构建必须禁用 dev 依赖且固定扩展版本
Webman 开发时常用的 phpunit、faker、debugbar 进入生产镜像后，不仅增大体积，还会因扩展版本冲突导致 swoole 启动失败或内存泄漏。
- Dockerfile 中明确指定 swoole 版本：
RUN pecl install swoole-5.1.2 && docker-php-ext-enable swoole，不要用pecl install swoole - 构建阶段分离：dev 依赖只在
build阶段安装，final阶段只复制vendor/autoload.php和bin/webman - PHP 配置关闭危险函数：
disable_functions = exec,passthru,shell_exec,system，微服务场景下不需要命令行执行能力 - 每个服务镜像打 tag 时带上 Git commit hash：
docker build -t user-service:20260522-abc123 .，便于快速定位线上问题版本
最难的不是让服务跑起来，而是让团队接受“一个 Bug 可能横跨三个服务的日志”。从 Webman 单体切过去的第一周，90% 的时间花在查 X-Request-ID 链路和对齐各服务的错误码定义上——这比写代码更消耗心力。
