Laravel 7中belongsTo关联使用category_id无效但使用id有效的问题排查

我来帮你一步步排查这个问题，先从几个最常见的原因入手：

1. 先确认数据库中的数据是否正确 #

这是最容易踩的坑：你给category_id设置了默认值0，但Laravel的自增ID默认是从1开始的，也就是说如果你的categories表中没有id=0的分类，那关联自然查不到数据。

你可以先手动检查products表的category_id字段，看看是否有值对应categories表中存在的id。比如执行SQL：

SELECT * FROM products WHERE category_id IN (SELECT id FROM categories);

如果这条查询返回的结果很少甚至为空，那就是数据的问题——要么给产品设置正确的category_id，要么去掉默认值（或者把默认值改成一个有效的分类ID）。

2. 查看实际执行的SQL语句 #

Laravel的查询日志能帮你直观看到关联查询到底用了什么条件，这是排查关联问题的利器。

在调用关联的代码前加上日志开启代码：

// 开启查询日志
DB::enableQueryLog();

// 调用你的关联
$product = Product::find(1);
$category = $product->category;

// 打印查询日志
dd(DB::getQueryLog());

然后看输出的SQL中，WHERE条件是不是categories.id = products.category_id？如果不是，那可能是关联定义有问题；如果是，但还是查不到数据，那回到第一步看数据是否匹配。

3. 确认模型命名空间与路径是否匹配 #

你在关联中写的是"App\Models\Category"，要确保你的Category模型确实在app/Models/Category.php路径下，并且类名是Category，命名空间是namespace App\Models;。如果路径或者命名空间错了，Laravel会找不到模型，关联也会失效。

4. 解释为什么用id作为外键会“生效” #

你提到用id作为外键时能匹配到分类，这其实是错误的关联逻辑：当你把外键指定为id时，Laravel会用products.id去匹配categories.id，刚好你的产品ID和某个分类ID相同，所以能返回数据，但这完全不是你想要的分类关联逻辑，只是巧合而已。

总结 #

大概率是products表中category_id的值不匹配categories表的有效ID（比如都是默认的0），先检查数据，再用查询日志验证SQL语句，基本就能定位问题了。

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