柠檬剧场·微服务重构分析报告

基于 FastAdmin (ThinkPHP 5) 单体架构向微服务架构演进的技术方案
📅 分析日期: 2026-07-08 📦 框架: FastAdmin / ThinkPHP 5 🗄️ 数据库: MySQL (Aliyun RDS) + Redis 📁 工作目录: app.zgddj.com

1 系统现状概览

131+
控制器文件
69
Model 模型
50+
Service 服务类
8
Addons 插件
5
Queue Job
31,864
核心代码行数

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授权UserAccountTokenUserServiceP0
2内容服务
Content Service
视频/短剧管理、剧集、分类、角标、脚本、追剧/收藏/分享VideoEpisodeCategoryVideoShareP0
3支付服务
Payment Service
充值/消费、金豆、VIP购买、支付宝/微信多端支付、虚拟支付PayPaywxPaylogGroupPayP0
4资产服务
Asset Service
余额/金币/金豆管理、积分、提现、资金流水、佣金结算TixianCoinBeansMoneyLogP0
5广告服务
Ad Service
广告位管理、广告池竞价、巨量引擎对接、收入统计AdspkAdvertisingAdServiceOceanengineP1
6风控服务
Risk Service
设备指纹、IP风控、黑名单、火山引擎、频控/屏蔽blackcube/*risk/*VolcServiceP1
7代理/分销服务
Agent Service
代理管理、佣金奖励、结算、银行卡、分销商/达人/零售商agent/*daili/*IncomeServiceP1
8统计分析服务
Analytics
播放统计、会员数据、剧集数据、充值数据、报表reports/*StatisticsLog*P2
9通知服务
Notification
短信验证码、推送消息、系统通知、邮件SmsNoticealismsP2
10任务/活动服务
Task Service
签到、任务组、红包活动、卡密兑换MytaskRedenvelopeSignKamiP2
11渠道服务
Channel
渠道管理、渠道用户、分享渠道channel/*SharechannelP2
12后台管理服务
Admin
管理员认证、RBAC权限、操作日志、系统配置auth/*general/*DashboardP2

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 / CheckBarrierFreeDNS/无障碍检测独立检测服务
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 JOINMySQL 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.jsPHP 团队学习曲线低,性能优异,部署简单
RPC 框架gRPCThrift / Dubbo多语言、强类型 IDL、生态成熟
消息队列Kafka (事件) + RabbitMQ (任务)RocketMQKafka 做事件总线,RabbitMQ 替 Redis Queue
API 网关APISIXKong高性能、插件丰富、gRPC-Web
配置中心NacosConsul+Apollo服务发现+配置中心一体化
OLAP 引擎ClickHouseDoris日志分析场景性能最优
分布式事务DTM (Saga)SeataGo 原生支持,轻量级
容器编排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 核心建议

  1. 先治理后拆分:在拆分前,先在单体中建立清晰的 Service 接口层、禁止跨模块直接查表。
  2. 绞杀者模式:不要一次性重写。先抽出用户服务,验证基础设施链路后再逐步替换。
  3. 资产服务优先:用户资产是核心也是最混乱的部分,优先独立,采用事件溯源模式。
  4. 支付链路必须 Saga:引入 DTM 或自研轻量 Saga 框架,确保最终一致性。
  5. 不要过早引入服务网格:Phase 0-3 使用 gRPC + API 网关即可。
  6. 保留 PHP 管理后台:通过 gRPC 网关调用后端服务,降低迁移成本。
  7. 可观测性先行:先搭分布式追踪、日志、监控三大支柱再写业务代码。
一句话总结:这是一个典型的"规模化短剧平台"从单体向微服务演进的标准路径。系统业务域清晰、边界明确,适合微服务化。建议采用渐进式绞杀者策略,以用户服务和资产服务为突破口,用 6-9 个月完成核心链路迁移。

报告生成时间: 2026-07-08 | 分析范围: /home/project/houtai/app.zgddj.com | 框架: FastAdmin (ThinkPHP 5)

本报告基于静态代码分析生成,实际情况请结合运行时数据综合判断。