hl-api-changelog/changelogs-v2/2026-06/11_3694_司机车辆列表日期筛选报错修复与车型图标长度放宽-修改接口-管理后台.md

【修复·管理后台】车务:司机/车辆列表日期筛选参数报错修复 + 车型大类图标长度放宽 64

存放目录: changelogs-v2/2026-06/ 涉及服务: hl-fleet-service(8087) PR: #3694 + #3695(文档版本记录)(均已合并 dev-v3,测试服已部署并 API 实测通过) | 无关联工单(用户即时报修) | 日期: 2026-06-11 影响范围: 管理后台司机档案/车辆档案列表筛选 + 车型大类新增/编辑

⚠️ 关键说明(前端必看 2 点)

1. 列表日期筛选现在能用了(之前一传就报错):司机列表 licenseExpireBefore/insuranceAnnualEndBefore、车辆列表 insureDueBefore/inspectDueBefore 四个 GET 日期参数,此前传 2026-07-11 这类标准格式直接报 Failed to convert ... LocalDate(后端缺日期绑定注解),现已修复。格式仍是 yyyy-MM-dd,请求/响应形状零变化,前端无需改任何代码,之前因报错被屏蔽的筛选交互可以放开。
2. 车型大类 icon 上限 8→64 字符:之前传图标组件名(如 BusOutline=10 字符)被 400「图标长度不能超过 8」拒(原按单 emoji 设计),现在最长 64,组件名或 emoji 都可以;超 64 报 400「图标长度不能超过 64」。

1. 日期筛选修复(4 个参数)

接口	参数	说明
GET /admin/fleet/drivers/page	licenseExpireBefore	驾照到期日 ≤ 该日(含),yyyy-MM-dd
GET /admin/fleet/drivers/page	insuranceAnnualEndBefore	年保到期日 ≤ 该日(含),仅 annual 行命中
GET /admin/fleet/vehicles/page	insureDueBefore	保险到期日 ≤ 该日(含)——同根因一并修,此前同样报错
GET /admin/fleet/vehicles/page	inspectDueBefore	年检到期日 ≤ 该日(含)——同上

测试服实测(用户原始报错 URL):

GET /admin/fleet/drivers/page?page=1&pageSize=24&season=active&insuranceAnnualEndBefore=2026-07-11&licenseExpireBefore=2026-08-10
→ {"code":200,"message":"成功","data":{"records":[],"total":0,...}}
   // 不再报 Failed to convert property value of type 'java.lang.String' to 'java.time.LocalDate'

2. 车型大类 icon 放宽

POST /admin/fleet/vehicle-types 与 PUT /admin/fleet/vehicle-types/{typeId} 入参 icon:≤8 → ≤64(DB 列同步 VARCHAR(8)→VARCHAR(64),Flyway V20260611_004 纯加宽,存量 emoji 图标无损)。

测试服实测(用户原始报错请求体):

PUT /admin/fleet/vehicle-types/2064609312168083458
{"typeKey":"mpv","typeName":"商务车","icon":"BusOutline","description":"高级团","sortOrder":99}
→ {"code":200,"message":"成功","data":{"id":"2064609312168083458","typeKey":"mpv","typeName":"商务车","icon":"BusOutline","description":"高级团","sortOrder":99,...}}
   // 列表回读 icon="BusOutline" 一致

3. 文档版本

FLEET API → v1.5.58 / FLEET DB → v1.5.25,文档站已同步:https://web.test.1814.love:9443/hl-docs/order-v3/api/API-SPEC-FLEET-V1.5.html