修复: 上架/完成设计校验跳过最后一天酒店(返程日豁免)

类型: 后端 BUG 修复关联: 工单 #1586 / PR #1587 日期: 2026-04-30 前端处理者: mmg 影响范围: 管理后台「完成设计」「提交审核 / 直接上架」按钮的预检逻辑

现象

用户反馈:产品上架/完成设计预检时,如果最后一天没在 product_day_hotel 配酒店,就被「Day N 住宿安排为空」拦截无法上架。但最后一天通常是返程日不需要住宿,这个校验是错的。

用户原文:「最后一天行程提示也得有住宿安排,实际不需要」

根因

hl-product-service-v2 ProductValidationService.validateItineraryCompleteness() 对每一天循环硬要求 product_day_hotel 非空,没有跳过最后一天。

修复

判定最后一天豁免酒店校验:

int totalDays = days.size();
for (int i = 0; i < totalDays; i++) {
    ProductItineraryDayDO day = days.get(i);
    // ... 描述/集合地/解散地/活动校验保持不变 ...

    // 最后一天通常是返程,不强制要求配酒店(2026-04-30 用户反馈)
    boolean isLastDay = (day.getDayNumber() != null)
            ? day.getDayNumber() == totalDays
            : i == totalDays - 1;
    if (!isLastDay) {
        if (dayHotels.isEmpty()) issues.add(dayLabel + " 住宿安排为空");
    }
}

判定规则:

优先 day.getDayNumber() == totalDays
dayNumber 为 null 时回退索引 i == totalDays - 1

行为变化

tripDays	最后一天	行为
1	i=0 是唯一一天即最后一天	单天产品没酒店通过
2	Day1 校验 / Day2 豁免	OK
3	Day1/Day2 校验 / Day3 豁免	OK
dayNumber=null	列表最后一项兜底	跳过

影响接口

方法	路径	改动
POST	`/admin/product/item/{id}/complete-design`	最后一天没酒店不再返 400
POST	`/admin/product/item/{id}/toggle-publish` (SUBMIT_PUBLISH/DIRECT_PUBLISH)	同上
PUT	`/admin/product/item/{id}/supplement`	不变(草稿允许任意)

请求/响应签名不变,只是错误条件减少。

前端要做的改动

0 改动。如果前端之前对「Day N 住宿安排为空」错误做过 UX 引导(比如跳到行程编排页面),保留即可,不会被误触发。

测试覆盖

新增 4 单测:

validateItinerary_lastDayNoHotel_shouldPass — 3 天 day3 没酒店,通过
validateItinerary_middleDayNoHotel_shouldFail — 3 天 day2 没酒店,报错;day3 不计入
validateItinerary_singleDay_noHotel_shouldPass — 1 天产品没酒店通过
validateItinerary_dayNumberNull_useListIndexFallback — dayNumber=null 兜底

mvn test: ProductValidationServiceTest 53/53 全绿。

部署状态

✅ 测试服 hl-product-service-v2 双实例部署完成(2026-04-30 23:40)
正式环境暂未发布(等 dev → main release PR)

2.9 KiB 原始文件 Blame 文件历史