跨数据库写入时事务不生效需为各库显式开启独立事务，禁用外层统一事务；避免模型事件中阻塞式跨库操作，改用带超时与重试的队列；跨库查询应切换连接而非用点号表名；同步失败须逐条捕获异常并记录完整上下文。
跨数据库写入时事务不生效怎么办
Laravel 默认的 DB::transaction() 只作用于当前连接，默认无法跨库回滚。比如你同时往 MySQL 主库和日志库写数据，主库失败了，日志库已经提交，事务就“漏”了。
- 必须为每个数据库连接显式开启独立事务：
DB::connection('mysql')->transaction()和DB::connection('log_db')->transaction()要分开包，不能套在一个外层DB::transaction()里 - 手动控制回滚顺序：先提交主业务库，再尝试写辅助库；若辅助库失败，需反向调用补偿逻辑（比如发消息、记表、触发重试），而不是指望自动回滚
- 注意连接配置里的
'strict' => true和'charset'一致，否则某些驱动（如 SQL Server）可能静默丢弃事务上下文
模型监听器里跨库保存引发死锁或超时
在 creating 或 saving 这类模型事件里直接操作另一个数据库，容易因连接池耗尽或网络延迟拖垮主请求。
- 禁止在 Eloquent 事件中做阻塞式跨库写入，尤其是同步调用
DB::connection('other')->table(...)->insert() - 改用队列：在事件里分发一个
SyncToExternalDatabaseJob，并在handle()中指定连接名：DB::connection('log_db') - 队列任务记得设置超时（
$timeout = 30）和重试次数（$tries = 3），避免失败任务卡住整个队列 - 如果必须实时，至少加
try/catch包裹，并记录Illuminate\Database\QueryException错误到storage/logs/sync_failures.log
使用 DB::table() 跨库查询时字段别名冲突
从 A 库查用户，再 join B 库的订单表（通过 database.table 形式），MySQL 允许但 Laravel 的 Query Builder 会把带点的表名当成嵌套结构，导致生成错误 SQL。
- 不要写
DB::table('log_db.orders')—— 它会被解析成表名是log_db.orders字符串，而非跨库引用 - 正确做法是先切换连接：
DB::connection('log_db')->table('orders')，再用selectRaw或原生join拼接 - 多库关联查询优先考虑应用层组装：先查主库 ID 列表，再用
whereIn去辅库捞数据，避免跨库 JOIN 引发权限或性能问题 - 注意 MySQL 用户权限是否包含对
log_db.*的SELECT，否则报错是SQLSTATE[HY000] [1045] Access denied，不是语法错
同步失败后怎么定位哪条记录卡住了
批量同步时只要一条出错，整个批次停摆，但默认日志只记到最后一条 ID，看不出是数据内容问题还是结构不匹配。
- 在循环同步逻辑里，对每条记录加
try/catch，捕获异常后立刻记录完整上下文：Log::error('Sync failed for user_id: '.$user->id, ['data' => $user->toArray(), 'exception' => $e->getMessage()]) - 避免用
DB::transaction()包整个 foreach，应按小批次（如 100 条）分段事务，降低单次失败影响面 - 给同步任务加唯一标识字段（如
sync_batch_id），失败时能快速在日志或数据库里 grep 到同一组记录 - 如果用了队列，记得在
failed()方法里补全原始 payload，否则artisan queue:failed-table里看不到具体参数
