# 接口变更记录 — 2026-03-30 17:11

> **提交** `f2bcbb4` · **作者** wx · **时间** 2026-03-30 17:11:21 +0800
>
> fix: 全面防御服务器内部错误（扫描前端+后端，83个文件）

## 变更总览

- **小程序聚合服务**
  - MpOrder (+1, 改1)
  - MpReview (+1, 改2)
  - MpSearch (+1, 改1)

---

## 小程序聚合服务

### MpOrder

> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 订单接口」**

### 🆕 `GET` /mp/order/mp/order

### ✏️ `GET` /mp/order/lookup — 通过联系人手机号+姓名查找订单（无需登录）

- 参数: contactPhone(String), contactName(String) → 无

### MpReview

> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 评价接口」**

### 🆕 `GET` /mp/review/mp/review

### ✏️ `GET` /mp/review/search — 关键词搜索评价(公开)

- 参数: keyword(String), targetType(String), targetId(Long), page(Integer), pageSize(Integer) → targetType(String), targetId(Long), page(Integer), pageSize(Integer)

### ✏️ `GET` /mp/review/featured — 精选评价列表(公开)

- 参数: limit(Integer) → 无

### MpSearch

> 📖 **接口文档**: [http://192.168.100.236:8086/doc.html](http://192.168.100.236:8086/doc.html) → 标签 **「C端 - 搜索接口」**

### 🆕 `GET` /mp/search/mp/search

### ✏️ `GET` /mp/search — 搜索产品

- 参数: keyword(String), productType(String), page(Integer), pageSize(Integer) → productType(String), page(Integer), pageSize(Integer)

---

## 📦 其他数据对象变更

> 以下变更未直接关联到本次接口变更，但可能影响现有接口的请求/响应

### 小程序聚合服务

#### ✏️ MpFeedbackRequest

  - ❌ ~~`images`~~ (`List<String>`) — 图片URL列表

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
M	hl-file-service/src/main/java/com/hulalv/file/dto/BatchFileRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/controller/MaterialTagController.java
M	hl-material-service/src/main/java/com/hulalv/material/dto/BatchDeleteRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/dto/BatchMaterialIdsRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/dto/BatchTagRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/dto/RefBatchBindRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/dto/RefBatchUnbindRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/feign/dto/FileBatchIdsRequest.java
M	hl-material-service/src/main/java/com/hulalv/material/service/MaterialRefService.java
M	hl-material-service/src/main/java/com/hulalv/material/service/MaterialService.java
M	hl-material-service/src/main/java/com/hulalv/material/service/MaterialTagService.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpActivityController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpAlbumController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpContractController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpCustomizeController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpDesignerController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpExploreController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpFavoriteController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpFootprintController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpHotelController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpMessageController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpOrderController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpProductController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpRestaurantController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpReviewController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpScenicController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpSearchController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/controller/MpWikiController.java
M	hl-mp-service/src/main/java/com/hulalv/mp/dto/MpFeedbackRequest.java
M	hl-mp-service/src/main/java/com/hulalv/mp/dto/MpProductQuoteRequest.java
M	hl-mp-service/src/main/java/com/hulalv/mp/dto/MpReviewCreateRequest.java
M	hl-mp-service/src/main/java/com/hulalv/mp/dto/MpTravelerRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/AdminCreateOrderRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/AlbumFileBatchAddRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/CreateOrderRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/MpUpdateOrderRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/RefundAppealRequest.java
M	hl-order-service/src/main/java/com/hulalv/order/dto/UpdateDepositRequest.java
M	hl-payment-service/src/main/java/com/hulalv/payment/dto/PrepayRequest.java
M	hl-payment-service/src/main/java/com/hulalv/payment/dto/RefundRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/controller/ProductController.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/ItineraryDayRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/NodeCreateRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/dto/PricingRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/feign/dto/BatchMaterialIdsRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/feign/dto/RefBatchBindRequest.java
M	hl-product-service/src/main/java/com/hulalv/product/feign/dto/RefBatchUnbindRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/BatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/service/ActivityService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/activity/service/ActivityTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/feign/dto/BatchMaterialIdsRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/feign/dto/RefBatchBindRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/feign/dto/RefBatchUnbindRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/controller/HotelTagController.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/BatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/service/HotelService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/hotel/service/HotelTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/restaurant/dto/BatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/restaurant/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/restaurant/service/RestaurantService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/restaurant/service/RestaurantTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/BatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/service/ScenicSpotService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/scenic/service/ScenicTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/dto/BatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/service/ServiceItemService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/service/service/ServiceTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/dto/StaffBatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/service/StaffService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/staff/service/StaffTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/supplies/dto/BatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/supplies/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/supplies/service/SuppliesService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/supplies/service/SuppliesTagService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/dto/BatchTagRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/dto/VehicleBatchDeleteRequest.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/service/VehicleModelService.java
M	hl-resource-service/src/main/java/com/hulalv/resource/vehicle/service/VehicleTagService.java
```
</details>