推荐用path字段（如"0-100-205-318"）存储多级分销关系，注册/升级时更新，开头统一为0；佣金计算应抽成CommissionService服务类，通过事件驱动；查下级用path LIKE + 字符串层级计算；佣金发放需通过commission_record表保障幂等与可追溯。
多级分销的层级关系怎么存到数据库里
直接用 parent_id 字段递归建树，查起来慢、改起来脆，尤其佣金结算时要遍历整条链路。更稳的做法是用 path 字段（如 "0-100-205-318"）或闭包表（user_ancestor），前者开发快，后者查得快、适合高并发结算。
ThinkPHP 中推荐在用户表加 path 字段，并在注册/升级时自动更新：
// 注册后更新 path $user = User::find($uid); $parent = User::find($user->pid); $user->path = $parent ? $parent->path . '-' . $parent->id : '0'; $user->save();
- 别用模型事件自动更新
path，容易在事务中漏掉或重复写 -
path开头统一用0表示根节点，避免空字符串导致 LIKE 查询失效 - 如果层级超 5 级，
path字段至少设为VARCHAR(255)
佣金计算逻辑该放在哪里写
不能写在控制器里——订单完成、退款、返利调整都可能触发佣金重算，放控制器会导致逻辑散落、难以维护。必须抽成独立服务类，比如 CommissionService，并用 ThinkPHP 的事件系统（event）驱动。
典型调用点：
立即学习“PHP免费学习笔记（深入）”；
- 订单状态变更为
paid时触发OrderPaid事件 - 退款成功时触发
RefundSucceed事件，反向扣减已发佣金 - 分销关系变更（如上级被冻结）需调用
rebuildCommissionChain()强制重算
佣金公式本身建议配置化，存在数据库或配置文件中，避免硬编码：
// config/commission.php
return [
'levels' => [1 => 10, 2 => 5, 3 => 2], // 一级10%，二级5%，三级2%
'min_amount' => 1.00,
];
怎么查某用户的全部下级并按级分组
用 path 字段配合 LIKE 和 LENGTH 是最直接的方式，比递归查询稳定得多：
User::where('path', 'like', $user->path . '-%')
->field('id, pid, path')
->select();
但要按“第1级”“第2级”分组，得靠字符串处理：
- MySQL 用
LENGTH(path) - LENGTH(REPLACE(path, '-', ''))算出层级数（注意减1才是相对当前用户的级差） - 或者在查出结果后，PHP 侧用
explode('-', $path)取倒数第 n 个 ID 来判断是否为某级下线 - 千万别用
with(['parent'])做 N+1 查询——1000 个下线就会发起 1000 次 SQL
如果频繁查多级关系，建议加组合索引：KEY idx_path_level (path, level)，其中 level 字段单独存，由业务逻辑维护。
佣金发放失败怎么保证幂等和可追溯
佣金不是“发了就行”，必须记录每笔计算依据和发放状态。建一张 commission_record 表，字段至少包括：order_id、user_id、level、amount、status（pending/success/failed）、calculation_data（JSON 存原始订单金额、比例、路径等）。
-
status必须用数据库唯一约束 + 事务控制，防止同一笔佣金重复发放 - 发放前先
INSERT ... ON DUPLICATE KEY UPDATE，主键设为order_id + user_id + level - 失败时不要静默重试，要把错误写进
calculation_data，比如"error": "balance_insufficient"
真正难的不是算出钱，而是当用户投诉“少发了一级佣金”时，能立刻拿出那条 commission_record 记录和它对应的 calculation_data —— 这才是分销系统可信的底线。
