Laravel中使用get_active_countries()无法获取活跃国家列表的解决方法

排查与解决步骤： #

• 验证数据库数据
  先直接执行SQL查询确认数据是否存在：

  SELECT * FROM countries WHERE status = 1;
  

  如果查询无结果，说明数据库中没有符合条件的记录，需先确认数据录入是否正确。

• 调试生成的SQL语句
  在辅助函数中添加调试代码，查看实际执行的SQL和绑定参数：

  if (!function_exists('get_active_countries')) {
      function get_active_countries()
      {
          $query = Country::isEnabled();
          // 打印SQL语句和绑定参数
          dd($query->toSql(), $query->getBindings());
          return $query->get();
      }
  }
  

  重点确认：

  • SQL中是否包含WHERE status = ?的条件
  • 若数据库中status字段存储为字符串类型（如'1'），需将模型scope方法中的条件改为where('status', '1')

• 检查模型字段可见性
  查看Country模型是否设置了$hidden属性隐藏status字段：

  // 若存在如下代码，移除status或确认是否需要隐藏
  protected $hidden = ['status'];
  

  隐藏字段会导致查询结果中不返回该字段，但实际数据是存在的。

• 确认辅助函数加载状态
  确保get_active_countries函数所在文件已被项目自动加载：

  • 若函数放在单独的辅助文件中，需在composer.json的autoload.files数组中添加文件路径：

    "autoload": {
        "files": [
            "app/Helpers/your-helper-file.php"
        ]
    }
    

  执行composer dump-autoload使配置生效。

• 清除缓存
  若项目使用了查询缓存，执行以下命令清理：

  php artisan cache:clear
  php artisan config:clear
  

优化后的辅助函数（简化写法）： #

if (!function_exists('get_active_countries')) {
    function get_active_countries()
    {
        return Country::isEnabled()->get();
    }
}

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