使用Laravel查询构造器when方法时必须添加return关键字吗？

很多人刚接触when方法时都会疑惑：官方示例里闭包明明已经调用了$query->where()修改查询条件，为啥还要多此一举写个return把对象传出去？

直接说结论 #

• 这不是PHP语法强制要求写的——你把return删掉，PHP根本不会报语法错。
• 但这是能保证代码稳定运行、不踩坑的标准写法，写不写return的实际逻辑差很多。

为啥大家会觉得return没必要？ #

困惑基本都来自两个认知差：

• PHP传对象给闭包的时候，传的是对象句柄不是副本，你在闭包里调$query->where(...)，确实会直接把查询条件叠加到原本的查询对象上，哪怕不return，这个where条件也能生效。
• 但很多人不知道，Laravel的when方法从设计之初就支持回调返回一个全新的查询实例——它会优先用回调返回的查询实例作为后续链式调用的上下文，只有当回调返回的不是有效查询对象时，才会兜底用原本的查询对象继续构建。

省略return的坑在哪？ #

对比下两种写法的实际运行逻辑就懂了：

• 带return的标准写法：闭包把加完where条件的查询实例直接返回，when收到这个有效实例后，直接把它往下传给后面的->get()，整个查询链的上下文连续，完全靠链式逻辑走，没有额外的兼容判断开销。
• 省略return的写法：闭包执行完$query->where(...)之后默认返回null，when看到返回值不是有效查询对象，就兜底回原来的查询实例（也就是你刚才在闭包里改过的那个）继续走链。
  这种写法能跑通，纯粹是Laravel做了兼容兜底，但如果你的回调逻辑复杂点——比如要根据不同条件返回完全不同的查询分支，省掉return就会直接把你新构建的查询逻辑丢了，后面的->get()还是跑在最开始的旧查询上，最后查出来的结果完全不对，排查起来特别费时间。

踩过坑的老开发者都知道：写when的回调时，不管逻辑多简单，只要操作完查询对象就顺手return一下，能省掉90%的上下文错乱类bug。

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