Laravel 9关联预加载失效问题（UUID以数字开头时异常）

核心原因推测 #

这个问题大概率是主键/外键类型不匹配或Laravel模型主键配置错误导致的：

• 当creatives表的uuid以1-9开头时，Laravel预加载可能错误地将字符串类型的uuid当作数值处理，触发SQL隐式类型转换，无法匹配creative_items表中的字符串外键；
• 以0或字母开头的uuid会被隐式转为0或保留字符串格式，反而能正常匹配关联数据。

分步解决步骤 #

1. 修正Creative模型的主键配置
   确保Creative模型正确声明uuid为非自增字符串主键：

   class Creative extends Model
   {
       protected $keyType = 'string';
       public $incrementing = false;
   
       // 关联定义
       public function creativeItems()
       {
           return $this->hasMany(CreativeItem::class, 'creative_uuid', 'uuid');
       }
   }
   

   注：必须明确$keyType = 'string'和$incrementing = false，否则Laravel会默认把主键当作自增整数处理，引发类型匹配错误。

2. 检查数据库字段类型一致性
   确认creatives表的uuid字段与creative_items表的creative_uuid字段，在数据库中是完全相同的字符串类型（例如均为varchar(36)），避免出现一个是字符串、一个是数值类型的情况。

3. 排查预加载的SQL查询差异
   开启查询日志对比预加载和延迟加载的SQL语句：

   DB::enableQueryLog();
   $creative = Creative::query()->whereCm360Id($cm360Id)->with('creativeItems')->first();
   dd(DB::getQueryLog());
   

   查看预加载creative_items的SQL，确认WHERE条件中creative_uuid的比较是否为字符串匹配（是否带引号）。如果SQL中把uuid当作数值（不带引号），说明模型主键配置错误导致类型识别异常。

4. 版本bug临时修复
   如果是Laravel 9.52.5的特定版本bug，可以尝试在预加载时显式指定字符串比较逻辑：

   $creative = Creative::query()
       ->whereCm360Id($cm360Id)
       ->with(['creativeItems' => function ($query) use ($creative) {
           $query->whereRaw("creative_uuid = ?", [$creative->uuid]);
       }])
       ->first();
   

   或者直接升级到Laravel 9.x的最新补丁版本，这类类型转换问题通常会在后续小版本中被修复。

验证方法 #

修改配置后，重新测试：

• 创建一条以1开头uuid的Creative记录，并关联对应的CreativeItem；
• 使用with('creativeItems')预加载，检查返回的关联集合是否正常填充。

内容的提问来源于stack exchange，提问作者Andrii