Laravel微服务间无限重试循环源于HTTP客户端未限制重试次数，导致失败→重试→再失败的雪崩；需配置retry middleware最大尝试次数、捕获RequestException降级处理，并禁用隐式重试。
微服务间调用引发的无限重试循环
当 Laravel 服务通过 HTTP 客户端（如 GuzzleHttp\Client）调用另一个微服务，而目标服务因配置错误、网络中断或自身崩溃返回 500/503 时，若未显式限制重试次数，retry 中间件或客户端默认行为可能触发隐式重试 —— 这不是“循环调用”，而是“失败→重试→再失败→再重试”的雪崩起点。
常见现象：日志里出现密集重复的相同请求 ID；Prometheus 指标显示某接口 QPS 突增但成功率趋近于 0；下游服务 CPU 瞬间拉满。
- 检查
config/services.php中 HTTP 客户端配置，确认是否启用了retry且未设max_attempts - 避免在
ApiGatewayController的routeRequest()方法里直接使用$client->request()而不传['http_errors' => false, 'timeout' => 5] - 所有跨服务调用必须包裹在
try/catch中，捕获GuzzleHttp\Exception\RequestException并立即降级（如返回缓存数据或空响应），而非原样抛出
Laravel-Admin 多数据库路由导致的事务嵌套死锁
在 laravel-admin 的 Grid 或 Form 中同时操作多个微服务数据库（比如主库写用户，订单库写订单），若未显式指定连接，Eloquent 默认走 default 连接；更危险的是，当某个字段使用 BelongsTo 关联跨库模型时，laravel-admin 可能自动开启事务并尝试在不同连接上执行 beginTransaction() —— MySQL 不允许跨连接事务，最终卡在 Waiting for table metadata lock。
典型报错：SQLSTATE[HY000]: General error: 1100 Table 'orders' was not locked with LOCK TABLES 或长时间无响应。
- 每个模型必须显式声明
protected $connection = 'orders';，不能依赖全局配置 - 禁用 laravel-admin 自动事务：在
Grid::make()前加DB::transaction(function () { ... }, 0);强制跳过事务包装 -
BelongsTo字段只用于展示，禁止在form()->saving回调中调用跨库模型的save()或update()
DataTables 服务器端分页与分布式 ID 冲突
当使用 yajra/laravel-datatables 的 DataTables::eloquent() 处理 UUID 主键模型时，若前端 DataTables 初始化时未设置 serverSide: true 或后端未启用 ->toJson()，它会退化为客户端渲染 —— 此时排序和搜索逻辑由 JS 执行，但 Eloquent 查询已按 UUID 字符串排序（如 ORDER BY "uuid" ASC），而 JS 的字符串排序规则与 PostgreSQL/MySQL 的 collation 不一致，导致翻页时数据重复或丢失。
更隐蔽的问题：分页参数 start 和 length 被忽略，全部数据被一次性查出，内存溢出。
- 强制启用服务器端处理：前端必须传
serverSide: true，后端必须调用->toJson()，二者缺一不可 - UUID 模型排序需改用二进制存储（
byteain PG /BINARY(16)in MySQL）并配合orderByRaw("encode(uuid, 'hex')")统一排序语义 - 禁用 DataTables 默认搜索：在初始化时设
searching: false，把搜索逻辑移到后端 API，避免客户端误判
权限系统跨服务角色同步引发的竞态条件
当多个微服务共用一套基于 Spatie\Permission 的权限表（如通过共享数据库或 API 同步），且都启用 syncPermissions() 或监听 RoleUpdated 事件时，两个服务几乎同时更新同一角色权限，就会触发数据库行锁竞争 —— 先提交的事务成功，后提交的事务因外键约束或唯一索引冲突失败，抛出 Integrity constraint violation，但错误被静默吞掉，导致权限实际未同步。
现象：A 服务给角色添加了 edit-posts 权限，B 服务却查不到；重启 B 服务后才生效。
- 禁用多服务自动同步：只允许一个权威服务（如 Auth Service）管理角色/权限，其他服务只读
- 所有权限变更必须走幂等 API：例如
PUT /api/roles/{id}/permissions接收完整权限列表，而非POST /api/roles/{id}/permissions增量添加 - 读取权限时缓存 30 秒，并设置
Cache::tags(['permissions'])->remember()，避免高频查询压垮 DB
