柠檬剧场·微服务重构分析报告
基于 FastAdmin (ThinkPHP 5) 单体架构向微服务架构演进的技术方案
📅 分析日期: 2026-07-08
📦 框架: FastAdmin / ThinkPHP 5
🗄️ 数据库: MySQL (Aliyun RDS) + Redis
📁 工作目录: app.zgddj.com
1 系统现状概览
1.1 技术栈
| 层级 | 技术选型 | 说明 |
| 框架 | FastAdmin (ThinkPHP 5.x) | 基于 ThinkPHP 5 的快速后台开发框架 |
| 语言 | PHP ≥ 7.2 | 无严格类型,面向过程与面向对象混用 |
| 数据库 | MySQL (Aliyun RDS, 单库) | 表前缀 fa_,无读写分离 |
| 缓存 | Redis (本地单机) | Session、缓存、队列、分布式锁共享同一实例 |
| 队列 | think-queue (Redis 驱动) | 金币兑换(KeepCoin)、补分结算(GapClosing)等异步任务 |
| 支付 | 支付宝 RSA2 + 微信支付 | 小程序、H5、公众号、APP、虚拟支付(米大师) |
| 短信 | 阿里云短信 (alisms) | 验证码发送 |
| 存储 | 阿里云 OSS / 腾讯云 COS | 图片、视频素材存储 |
| 风控 | 火山引擎 + Black Cube 自研 | 设备指纹、注册风控、微信授权风控 |
| 广告投放 | 巨量引擎 (Ocean Engine) | 广告数据回传 (MarketingCallback) |
1.2 当前架构拓扑
┌─────────────────────────────────────────────────────┐
│ PHP-FPM (单一入口) │
│ public/index.php → application/ │
│ │
│ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────────┐ │
│ │ api/ │ │ admin/ │ │ index/ │ │ common/ │ │
│ │ 移动端 │ │ 管理后台│ │ H5前端 │ │ 模型/服务 │ │
│ └───┬────┘ └───┬────┘ └───┬────┘ └─────┬──────┘ │
│ └──────────┴──────────┴────────────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ │ │ │ │
│ ┌────┴────┐ ┌────┴────┐ ┌────┴────────┐ │
│ │ MySQL │ │ Redis │ │ 外部服务(直连)│ │
│ │ (RDS) │ │ (单机) │ │ 支付宝/微信 │ │
│ └─────────┘ └────────┘ │ 火山/OSS/COS │ │
│ └─────────────┘ │
└─────────────────────────────────────────────────────┘
2 业务域识别与服务拆分建议
通过对 131 个控制器、69 个模型、50+ 服务类的分析,识别出 12 个核心业务域:
| # | 微服务 | 职责范围 | 涉及模块 | 优先级 |
| 1 | 用户服务 User Service | 注册/登录/认证、实名认证、设备管理、邀请绑定、微信/Apple授权 | UserAccountTokenUserService | P0 |
| 2 | 内容服务 Content Service | 视频/短剧管理、剧集、分类、角标、脚本、追剧/收藏/分享 | VideoEpisodeCategoryVideoShare | P0 |
| 3 | 支付服务 Payment Service | 充值/消费、金豆、VIP购买、支付宝/微信多端支付、虚拟支付 | PayPaywxPaylogGroupPay | P0 |
| 4 | 资产服务 Asset Service | 余额/金币/金豆管理、积分、提现、资金流水、佣金结算 | TixianCoinBeansMoneyLog | P0 |
| 5 | 广告服务 Ad Service | 广告位管理、广告池竞价、巨量引擎对接、收入统计 | AdspkAdvertisingAdServiceOceanengine | P1 |
| 6 | 风控服务 Risk Service | 设备指纹、IP风控、黑名单、火山引擎、频控/屏蔽 | blackcube/*risk/*VolcService | P1 |
| 7 | 代理/分销服务 Agent Service | 代理管理、佣金奖励、结算、银行卡、分销商/达人/零售商 | agent/*daili/*IncomeService | P1 |
| 8 | 统计分析服务 Analytics | 播放统计、会员数据、剧集数据、充值数据、报表 | reports/*StatisticsLog* | P2 |
| 9 | 通知服务 Notification | 短信验证码、推送消息、系统通知、邮件 | SmsNoticealisms | P2 |
| 10 | 任务/活动服务 Task Service | 签到、任务组、红包活动、卡密兑换 | MytaskRedenvelopeSignKami | P2 |
| 11 | 渠道服务 Channel | 渠道管理、渠道用户、分享渠道 | channel/*Sharechannel | P2 |
| 12 | 后台管理服务 Admin | 管理员认证、RBAC权限、操作日志、系统配置 | auth/*general/*Dashboard | P2 |
3 当前架构核心问题
🔴 数据库强耦合
所有模块共用同一 MySQL 数据库(单库单实例),表前缀 fa_。控制器中大量使用 Db::name('table') 直接跨域访问:
- User 控制器直接查
fa_video_order、fa_paylog
- Pay 控制器直接写
fa_user 余额字段
- Risk 模块直接读
fa_user 设备信息
影响:任何表结构变更都可能影响多个模块,无法独立演进。
🔴 事务跨域
支付回调 serverNotice() 在一个 DB 事务中同时操作:
- 用户金豆余额 (fa_user.beans)
- 支付日志 (fa_paylog)
- 统计数据 (Statistics)
- 佣金结算 (yongjin/dailiyongjin)
- 巨量引擎回传 (MarketingCallback)
- 分销商佣金 (retailerBrokerageSettlement)
影响:拆分为微服务后,分布式事务是核心挑战。
🔴 代码层面耦合
- API 控制器直接实例化 Admin 模型
- 控制器饱含业务逻辑(User 控制器 1800+ 行)
- Service 类实例化 Model 而非接口
- OSS URL 硬编码散落各处
config('site') 随意读取
🟡 基础设施耦合
- Redis 单机:Session + 缓存 + 队列 + 锁 混用
- 文件上传直写本地磁盘
./uploads/
- 日志直接写文件,无集中收集
- 无 API 网关,客户端直连 PHP-FPM
- 第三方地址硬编码在 .env 和 site.php
关键风险:支付回调 serverNotice() 中混合了 6 种不同的业务操作在一个 DB 事务中,拆分时需重点设计 Saga 补偿模式。
4 目标微服务架构设计
4.1 整体架构图
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
客户端层 │ 微信小程序 │ │ APP │ │ H5 │ │ 管理后台 │
└─────┬─────┘ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
└──────────────┴──────────────┴──────────────┘
│
┌────────────────┴────────────────┐
│ API Gateway (APISIX) │
│ 认证·限流·路由·日志·灰度 │
└────────────────┬────────────────┘
│
┌───────────────────────────────────────┼───────────────────────────────────┐
│ 服务网格 / 服务总线 (gRPC + REST) │
│ Consul/Nacos 服务发现 + Jaeger 链路追踪 │
└───────────────────────────────────────┼───────────────────────────────────┘
│
┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐┼┐ ┌───────┐ ┌───────┐ ┌───────┐
│ 用户 │ │ 内容 │ │ 支付 │ │ 资产 ││ │ 广告 │ │ 风控 │ │ 代理 │
│Service│ │Service│ │Service│ │Service││ │Service│ │Service│ │Service│
└───┬───┘ └───┬───┘ └───┬───┘ └───┬───┘│ └───┬───┘ └───┬───┘ └───┬───┘
└─────────┴─────────┴─────────┴─────┴─────┴─────────┴─────────┘
│
┌───────────────────────────────────────┼───────────────────────────────────┐
│ 基础设施层 │
│ MySQL集群(每服务独立DB) │ Redis集群 │ RabbitMQ/Kafka │ MinIO/OSS │ ELK │
└───────────────────────────────────────────────────────────────────────────┘
4.2 服务间通信策略
| 通信模式 | 适用场景 | 技术选型 |
| 同步 RPC | 实时查询(获取用户信息、视频详情) | gRPC (Protocol Buffers) |
| 异步消息 | 事件驱动(支付成功→发金币→记流水→通知) | RabbitMQ / Kafka |
| 事件总线 | 跨服务状态同步(注册→初始化资产→欢迎通知) | Kafka + Avro Schema |
| CQRS | 高频读场景(视频列表、排行榜) | MySQL(写) + ES(读) |
4.3 关键技术决策
| 决策点 | 建议方案 | 理由 |
| 语言选型 | Go (主力) + 保留 PHP 过渡 | Go 并发优异、部署简单;PHP 兼容过渡 |
| 数据库策略 | Database per Service | 每服务独立 DB,通过 API 获取数据 |
| 分布式事务 | Saga + 本地消息表 | 支付→资产→统计链路保证最终一致性 |
| API 网关 | APISIX | 高性能、插件丰富、gRPC-Web 支持 |
| 服务发现 | Nacos / Consul | 服务发现+配置中心 |
| 容器编排 | Kubernetes (ACK) | 自动扩缩容、滚动更新、自愈 |
| 链路追踪 | Jaeger / SkyWalking | 全链路追踪、性能瓶颈定位 |
| 日志 | Filebeat → ES → Kibana | 集中日志、全文检索、告警 |
5 核心服务详细设计
5.1 用户服务 P0
数据边界
| 原表 | 归属 | 说明 |
fa_user | 用户服务 | 核心用户表,其他服务仅保留 user_id |
fa_user_group | 用户服务 | 用户组/等级 |
fa_user_whitelist | 用户服务 | 白名单 |
fa_user_feedback | 用户服务 | 用户反馈 |
关键事件
UserRegistered → 触发资产服务初始化账户
UserRealNameAuthed → 触发风控服务校验
UserBoundParent → 触发代理服务更新关系
5.2 支付服务 + 资产服务 P0
支付回调 Saga 编排
支付成功事件 → [Saga Orchestrator]
├── Step 1: 更新支付订单 (支付服务) ← 同步
├── Step 2: 增加金豆/余额 (资产服务) ← 失败补偿 Step 1
├── Step 3: 记录流水 (资产服务) ← 失败补偿 Step 2
├── Step 4: 计算佣金 (代理服务) ← 失败重试
├── Step 5: 回传数据 (广告服务) ← 失败重试
└── Step 6: 写入统计 (分析服务) ← 失败重试
设计要点:资产服务建议采用事件溯源 (Event Sourcing) 模式记录所有资产变动,天然支持审计和对账。当前队列任务 KeepCoin、GapClosing 需迁移为定时 Saga。
5.3 风控服务 P1
现有 Black Cube 风控体系
| 子模块 | 功能 | 拆分建议 |
| BlackDevice / BlackDeviceIdentifier | 设备指纹采集 | 独立为设备指纹服务 |
| BlackLocation / BlackFingerprint | 位置/浏览器指纹 | 合并到风控规则引擎 |
| CheckDns / CheckBarrierFree | DNS/无障碍检测 | 独立检测服务 |
| VolcService | 火山引擎对接 | 风控服务下游适配器 |
| risk/* (ClickRate, Shielding) | 频控/扣量/屏蔽 | 风控规则引擎核心 |
5.4 内容服务 P0
数据边界
| 原表 | 归属 | 原表 | 归属 |
| fa_videolist | 内容服务 | fa_video | 内容服务 |
| fa_category | 内容服务 | fa_chapter / fa_script | 内容服务 |
| fa_videolove | 内容服务 | fa_videorecord | 内容服务 |
| fa_videoshare* | 内容服务 | fa_juese | 内容服务 |
优化方向:视频列表、搜索等高读场景引入 Elasticsearch 做读分离。视频素材统一走 CDN + 对象存储。
6 数据迁移策略
6.1 数据库拆分方案
| 阶段 | 操作 | 工具 |
| Phase 1: 逻辑拆分 | 按服务创建 schema/view,禁止跨 schema JOIN | MySQL Schema + 代码规范 |
| Phase 2: 物理拆分 | 逐服务迁移到独立 DB,CDC 增量同步 | Debezium + Kafka Connect |
| Phase 3: 外键解耦 | 保留业务 ID,关联数据通过服务调用获取 | BFF / GraphQL 重组 |
6.2 关键迁移项
| 数据 | 迁移方向 | 挑战 |
| fa_user 余额/金币/金豆字段 | → 资产服务独立表 | 需双写过渡,保证强一致性 |
| fa_paylog | → 支付服务独立表 | 支付回调需兼容新老逻辑 |
| fa_money_log 等流水表 | → 资产服务独立表 | 数据量大,需分批迁移 |
| fa_log_play / fa_log_video | → 分析服务 + ClickHouse | 建议直接迁到 OLAP 引擎 |
双写策略:过渡期间 PHP 单体继续写原库,同时通过消息队列异步写入新服务 DB。数据校验工具对比两边数据,一致后切换读流量。
7 分阶段实施路线图
Phase 0 — 基础设施准备 (2-3 周)
- 搭建 K8s 集群(开发/测试/生产)
- 部署 APISIX 网关、Nacos/Consul 服务发现
- 部署 RabbitMQ/Kafka 集群
- 部署 ELK + Prometheus + Grafana 监控
- 建立 CI/CD 流水线和 Proto/gRPC 规范
Phase 1 — 用户服务 + 网关 (4-6 周)
- 拆出用户服务(Go 实现),JWT 统一认证
- PHP 单体通过 gRPC 调用户服务
- 保留 PHP 登录/注册接口过渡
Phase 2 — 资产服务 + 支付服务 (6-8 周)
- 余额/金币/金豆独立为资产服务
- 支付网关独立,支付回调改为 Kafka 事件
- 实现 Saga 编排器
- 提现服务独立
Phase 3 — 风控服务 + 内容服务 (5-7 周)
- Black Cube 完整迁移到风控服务
- 内容服务独立,搜索引入 ES
- 广告服务拆分
Phase 4 — 代理服务 + 分析服务 (4-6 周)
- 代理/分销体系独立
- 统计分析引入 ClickHouse
- 播放/行为日志实时入湖
Phase 5 — 剩余服务 + 下线单体 (4-5 周)
- 通知/任务/渠道服务独立
- 管理后台 BFF 重构
- 逐步下线 PHP 单体
总预估工期:25-35 周 (约 6-9 个月)。建议采用 绞杀者模式 (Strangler Fig Pattern),逐步替换而非一次性重写。
8 技术选型建议
| 组件 | 推荐方案 | 备选 | 选型理由 |
| 后端语言 | Go (Kratos/Go-Zero) | Java / Node.js | PHP 团队学习曲线低,性能优异,部署简单 |
| RPC 框架 | gRPC | Thrift / Dubbo | 多语言、强类型 IDL、生态成熟 |
| 消息队列 | Kafka (事件) + RabbitMQ (任务) | RocketMQ | Kafka 做事件总线,RabbitMQ 替 Redis Queue |
| API 网关 | APISIX | Kong | 高性能、插件丰富、gRPC-Web |
| 配置中心 | Nacos | Consul+Apollo | 服务发现+配置中心一体化 |
| OLAP 引擎 | ClickHouse | Doris | 日志分析场景性能最优 |
| 分布式事务 | DTM (Saga) | Seata | Go 原生支持,轻量级 |
| 容器编排 | Kubernetes (ACK) | Swarm | 行业标准,阿里云托管 |
9 风险与缓解措施
| 风险 | 等级 | 影响 | 缓解措施 |
| 分布式事务数据不一致 | 高 | 支付链路异常,用户资金损失 | Saga 补偿 + 本地消息表 + 每日对账 + 人工兜底 |
| 服务间调用延迟叠加 | 中 | 体验下降,超时雪崩 | 减少链式调用、缓存、熔断降级、异步非关键路径 |
| 团队技能转型 | 中 | 短期效率下降 | 先培训 Go,Phase 0-1 为学习缓冲期 |
| 数据库迁移数据丢失 | 中 | 用户资产异常 | 双写+校验+全量备份+灰度+快速回滚 |
| 运维复杂度剧增 | 中 | 故障定位困难 | 投入 SRE,完善监控,自动化部署 |
| 第三方服务兼容性 | 低 | 支付/风控对接中断 | 封装 Adapter 层,接口不变 |
10 总结与建议
10.1 是否应该微服务化?
✅ 支持拆分的理由
- 12 个清晰的业务域,边界明确
- 支付/资产模块对一致性要求极高,适合独立演进
- 风控体系已半独立 (Black Cube),拆分成本低
- 分析统计适合独立 OLAP 引擎 (ClickHouse)
- 当前单体代码耦合严重,重构势在必行
- 各模块流量模型差异大,独立扩缩容收益显著
⚠️ 需要注意的风险
- 团队规模需至少 5-8 人
- 运维能力要求显著提升
- 分布式事务(支付→资产→佣金)是最大技术挑战
- PHP → Go 有学习成本
- 过度拆分会导致"分布式单体"
10.2 核心建议
- 先治理后拆分:在拆分前,先在单体中建立清晰的 Service 接口层、禁止跨模块直接查表。
- 绞杀者模式:不要一次性重写。先抽出用户服务,验证基础设施链路后再逐步替换。
- 资产服务优先:用户资产是核心也是最混乱的部分,优先独立,采用事件溯源模式。
- 支付链路必须 Saga:引入 DTM 或自研轻量 Saga 框架,确保最终一致性。
- 不要过早引入服务网格:Phase 0-3 使用 gRPC + API 网关即可。
- 保留 PHP 管理后台:通过 gRPC 网关调用后端服务,降低迁移成本。
- 可观测性先行:先搭分布式追踪、日志、监控三大支柱再写业务代码。
一句话总结:这是一个典型的"规模化短剧平台"从单体向微服务演进的标准路径。系统业务域清晰、边界明确,适合微服务化。建议采用渐进式绞杀者策略,以用户服务和资产服务为突破口,用 6-9 个月完成核心链路迁移。
报告生成时间: 2026-07-08 | 分析范围: /home/project/houtai/app.zgddj.com | 框架: FastAdmin (ThinkPHP 5)
本报告基于静态代码分析生成,实际情况请结合运行时数据综合判断。