Laravel使用api.php路由时出现sequence_id未定义错误

问题原因 #

你遇到的报错本质是代码本身存在逻辑缺陷，web路由运行正常只是刚好没有触发边界条件：

1. 你的$sequence_id、$prefix、$no三个变量仅在foreach循环内部赋值，如果$sequence查询结果为空，循环不会执行，这三个变量就处于未定义状态，直接调用就会抛出undefined variable错误。
2. api路由下查询返回空，是web和api路由的运行环境差异导致的，常见原因包括：
   • 两个路由组加载的数据库配置不同，pgsql2连接指向了不同的数据库
   • api路由中间件存在租户切换、数据库连接重写的逻辑，修改了默认的连接配置
   • pgsql对字段名大小写敏感，如果prefix字段实际为大写格式（如PREFIX），小写查询会导致条件失效
   • 你贴出的查询结果中，返回的数据集根本不存在prefix字段，也可能是字段名拼写错误导致查询条件不匹配

修复方案 #

首先修复代码本身的边界问题，提前初始化变量，同时优化查询逻辑（你实际只需要单条数据，无需遍历集合）：

// 提前初始化变量，避免未定义报错
$sequence_id = '';
$prefix = '';
$no = 0;

$sequence = DB::connection('pgsql2')
    ->table('ad_sequence')
    ->where('prefix', 'PR.')
    ->first(); // 直接取第一条匹配数据，无需遍历整个集合

if ($sequence) {
    $sequence_id = $sequence->ad_sequence_id;
    $prefix = $sequence->prefix ?? '';
    $no = $sequence->currentnext;
}

$data_array = [
    "data" => [
        "entityName" => "sequence",
        "organization" => "school",
        "description" => "test",
        "userContact" => $sequence_id,
        "document" => $prefix.$no
    ]
];

return $data_array;

后续排查项 #

如果修复后api路由返回的数据为空，按以下步骤排查：

• 分别在web和api路由中打印DB::connection('pgsql2')->getDatabaseName()，确认连接的是同一个数据库
• 打印查询生成的SQL语句，确认条件符合预期：dd(DB::connection('pgsql2')->table('ad_sequence')->where('prefix', 'PR.')->toSql());，将生成的SQL直接放到数据库执行确认是否有结果
• 如果是pgsql字段大小写问题，修改查询条件为whereRaw('"prefix" = ?', ['PR.'])验证

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