Laravel 的数据库查询默认不保证结果顺序，若未显式排序，凌晨（如 1:30 AM）等跨日时间可能因底层排序逻辑被错误跳过；必须使用 orderBy('departure_time') 显式按时间升序排列，确保下一个最近班次（含午夜后时间）准确返回。
laravel 的数据库查询默认不保证结果顺序，若未显式排序，凌晨（如 1:30 am）等跨日时间可能因底层排序逻辑被错误跳过；必须使用 `orderby('departure_time')` 显式按时间升序排列，确保下一个最近班次（含午夜后时间）准确返回。
在构建轮渡时刻表展示系统时，一个常见却容易被忽视的问题是：当数据库中 departure_time 字段（如 TIME 类型）未按时间逻辑排序时，whereTime('departure_time', '>', now()) 查询虽能筛选出“未来出发时间”，但结果集本身无序，导致 Laravel 默认返回的首条记录未必是真正“下一个最近”的班次——尤其当存在跨午夜的时间（如 01:30:00）而数据物理存储顺序混乱时，该记录可能被排在后面甚至被 groupBy 非预期地截断。
✅ 正确做法是在查询链中显式添加时间排序：
use Illuminate\Support\Facades\DB;
use Carbon\Carbon;
$nextFerries = DB::table('ferries')
->groupBy('ferry_name')
->whereTime('departure_time', '>', Carbon::now()->toTimeString())
->whereIn('schedule_type', ['Weekday'])
->where('terminal_name', $terminal_name)
->orderBy('departure_time') // ← 关键：按 departure_time 升序排列，确保最早未来时间排第一
->get()
->all();⚠️ 注意事项：
- orderBy('departure_time') 依赖数据库字段类型为 TIME 或 DATETIME；若 departure_time 是字符串（如 VARCHAR 存储 '1:30 am'），排序将按字典序进行（'1:30 am' < '6:30 am' ✅，但 '10:00 am' 会排在 '1:30 am' 前 ❌），强烈建议统一使用 TIME 类型并存储 24 小时制格式（如 '01:30:00'）；
- groupBy('ferry_name') 与 orderBy 共用时，需确保 MySQL SQL 模式兼容（如禁用 ONLY_FULL_GROUP_BY），否则可能报错；更健壮的做法是配合聚合函数（如 MIN(departure_time)）或改用窗口函数（Laravel 9+ 可结合 selectRaw 实现）；
- 若需支持“当日无班次时自动取次日首个班次”，当前逻辑不满足——它仅查“今天内未来时间”。此时应改用日期时间混合判断（如 WHERE departure_datetime > NOW()，字段类型推荐 DATETIME）。
总结：数据库查询结果天然无序，whereTime 仅负责过滤，不负责排序。要确保“下一个最近班次”准确呈现，orderBy('departure_time') 不是可选项，而是必选项。同时，请校验时间字段的数据类型与存储规范，这是时间逻辑可靠性的底层基础。
