手动导入CSV后Laravel中TestDirectory模型无法获取MySQL数据

1. 核对模型与数据表的映射配置 #

• 确认模型的$table属性是否正确指定为test-directory，因为表名包含横杠，无法通过Laravel自动命名规则匹配，必须手动设置：

  protected $table = 'test-directory';
  

• 检查主键配置：如果数据表的主键不是默认的id，或者主键为非自增类型，需要在模型中手动指定$primaryKey和$incrementing属性：

  protected $primaryKey = 'custom_id';
  public $incrementing = false; // 主键非自增时设置
  

• 验证时间戳配置：如果数据表没有created_at和updated_at字段，需在模型中添加public $timestamps = false;，否则Laravel会自动在查询中加入这两个字段的条件，导致数据无法匹配。

2. 确认CSV导入的数据有效性 #

• 直接在phpMyAdmin中执行SELECT * FROM test-directory;，确认数据确实已成功导入，无字段类型不匹配、主键重复被忽略等导入错误。
• 检查模型的$hidden属性：如果导入的字段被添加到$hidden数组中，all()返回的结果会隐藏这些字段，但数据本身仍存在，可通过TestDirectory::get()->toArray()查看完整数据。

3. 检查数据库连接与环境一致性 #

• 核对.env文件中的DB_DATABASE、DB_HOST等配置，确保Laravel应用连接的数据库与phpMyAdmin操作的是同一个。
• 执行php artisan config:clear清除配置缓存，避免应用加载旧的数据库配置。

4. 排查模型的作用域限制 #

• 检查TestDirectory模型是否存在全局作用域（如boot方法中通过addGlobalScope添加的过滤条件），这类作用域会自动附加到所有查询，可能过滤掉手动导入的数据。
• 尝试执行TestDirectory::withoutGlobalScopes()->get()，排除全局作用域的影响，验证是否能获取数据。

5. 验证软删除配置 #

• 如果模型引入了SoftDeletes trait，需确认导入数据的deleted_at字段值为NULL。若该字段有值，Laravel默认会过滤掉这些数据，可通过TestDirectory::withTrashed()->get()测试是否存在软删除数据。

6. 查看原始SQL查询语句 #

• 开启Laravel查询日志，查看TestDirectory::all()生成的SQL语句，对比手动执行的结果：

  DB::enableQueryLog();
  TestDirectory::all();
  dd(DB::getQueryLog());
  

  将输出的SQL复制到phpMyAdmin中执行，确认是否能返回数据，以此定位是查询逻辑问题还是数据本身的问题。

7. 检查字段大小写与编码匹配 #

• 确认Linux环境下数据库是否配置了字段名大小写敏感，若数据表字段名与模型中使用的大小写不一致，可能导致查询失败。
• 验证CSV文件编码与数据库编码一致（如均为UTF-8），避免因乱码导致的数据匹配异常。

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