递归函数返回空的主因是未在每条分支显式 return；如调用自身时写 findKey($v, $target) 却未加 return，导致上层接收 NULL，需用 strict_types、类型检查或静态分析工具定位。
递归函数没返回值，是因为忘了在每条分支上写 return
PHP 递归函数返回空，最常见原因是：调用自身时写了 recursive_func($next)，但没加 return。PHP 不会自动把子调用结果“透传”上来，必须显式 return。
比如计算阶乘的错误写法：
function factorial($n) {
if ($n <= 1) {
return 1;
}
factorial($n - 1) * $n; // ❌ 缺少 return，这行结果被丢弃
}正确写法是：
function factorial($n) {
if ($n <= 1) {
return 1;
}
return factorial($n - 1) * $n; // ✅ 必须 return
}- 所有分支（包括
if、else、循环末尾）都要有明确的return，否则默认返回NULL - 递归调用那一行，前面不加
return，就等于“执行但丢弃结果” - 调试时可加
var_dump(__FUNCTION__, $n, $result);确认每层是否真返回了值
接收递归结果时，误把中间过程当最终结果
有人在递归里用全局变量或引用参数收集数据，却忘了主调用处仍需从函数获取返回值。函数本身不返回，外部变量再怎么改，$res = my_recursive(...) 还是 NULL。
立即学习“PHP免费学习笔记（深入）”；
例如遍历目录并收集文件路径，错误示范：
$files = [];
function listFiles($dir) {
global $files;
foreach (scandir($dir) as $f) {
$path = "$dir/$f";
if (is_file($path)) $files[] = $path;
if (is_dir($path) && $f !== '.' && $f !== '..') {
listFiles($path); // ❌ 没 return，也不影响 $files 的赋值逻辑
}
}
}
$result = listFiles('/tmp'); // $result 是 NULL，不是数组更可靠的方式是让函数自己返回结果：
function listFiles($dir) {
$files = [];
foreach (scandir($dir) as $f) {
$path = "$dir/$f";
if (is_file($path)) {
$files[] = $path;
}
if (is_dir($path) && $f !== '.' && $f !== '..') {
$files = array_merge($files, listFiles($path)); // ✅ 合并子调用结果
}
}
return $files; // ✅ 每次都返回当前层级结果
}- 避免依赖全局变量传递递归结果，容易混淆作用域和生命周期
- 若必须用引用传参（如性能敏感场景），调用时仍要确保函数有
return，哪怕只是return true; -
array_merge()在深层递归中可能有性能开销，大数据量可考虑先收集再一次性yield或用栈模拟
递归深度超限导致未走到 return 就报错退出
PHP 默认递归限制是 100 层（xdebug.max_nesting_level=256 常见），一旦触发 Fatal error: Maximum function nesting level of '256' reached，函数会中断，自然没有返回值。
- 用
ini_get('xdebug.max_nesting_level')查当前限制（Xdebug 开启时） - 不用 Xdebug 时看
zend_extension是否加载，或直接测试debug_backtrace()深度 - 临时调高限制仅用于调试，生产环境应优化逻辑（如改用 while + 栈）
- 加保护性判断，比如
if ($depth > 100) { throw new RuntimeException('Too deep'); }
返回值类型不一致，弱类型导致隐式转换成空
递归中不同分支返回不同类型（如有的返字符串，有的返数组，有的漏写 return），PHP 可能静默转成 NULL 或空数组，尤其在开启 strict_types=1 时直接报错。
示例问题代码：
function findKey($arr, $target) {
foreach ($arr as $k => $v) {
if ($k === $target) return $v;
if (is_array($v)) {
findKey($v, $target); // ❌ 这里没 return，上层拿到 NULL
}
}
}检查方法：
- 启用
declare(strict_types=1);强制类型声明，提前暴露不一致 - 用
gettype()或var_export()打印每层返回值类型 - IDE 中开启 PHPStan 或 Psalm 静态分析，能捕获“Missing return statement”类警告
递归不是魔法，它只是函数调用套函数调用。哪一层没 return，它的上一层就拿不到东西——这个链条断在哪，结果就空在哪。
