fix: return A0404 for missing PDA pallets

lastleg-service/src/main/java/com/baiyue/lastleg/palletops/gateway/HttpPalletPhysicalGateway.java

@@ -6,8 +6,10 @@ import jakarta.annotation.PostConstruct;
 import jakarta.annotation.Resource;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.HttpStatusCode;
+import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Component;
 import org.springframework.web.client.RestClient;
+import org.springframework.web.server.ResponseStatusException;
 
 import java.util.LinkedHashMap;
 import java.util.Map;
@@ -31,12 +33,24 @@ public class HttpPalletPhysicalGateway implements PalletPhysicalGateway {
         ResolveEnvelope response = client.get().uri("/internal/v1/warehouse-pallets/resolve/{code}", palletCode)
             .header("X-Internal-Service-Token", internalToken).retrieve()
             .onStatus(HttpStatusCode::isError, (request, result) -> {
-                throw new IllegalArgumentException("Warehouse rejected pallet scan: HTTP " + result.getStatusCode());
+                throw palletLookupFailure(result.getStatusCode());
             }).body(ResolveEnvelope.class);
-        if (response == null || response.data() == null) throw new IllegalStateException("Warehouse returned no pallet");
+        if (response != null && "A0404".equals(response.code())) {
+            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Warehouse pallet was not found");
+        }
+        if (response == null || response.data() == null) {
+            throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE,
+                "Warehouse pallet service returned no usable response");
+        }
         return response.data();
     }
 
+    private ResponseStatusException palletLookupFailure(HttpStatusCode status) {
+        return new ResponseStatusException(status.value() == 404 ? HttpStatus.NOT_FOUND
+            : (status.is4xxClientError() ? HttpStatus.BAD_REQUEST : HttpStatus.SERVICE_UNAVAILABLE),
+            status.value() == 404 ? "Warehouse pallet was not found" : "Warehouse pallet lookup failed");
+    }
+
     @Override
     public LocationReference resolveLocation(long warehouseId, long locationId) {
         LocationEnvelope response = client.get().uri(uri -> uri
@@ -76,7 +90,7 @@ public class HttpPalletPhysicalGateway implements PalletPhysicalGateway {
             }).toBodilessEntity();
     }
 
-    private record ResolveEnvelope(PalletReference data) { }
+    private record ResolveEnvelope(String code, String message, PalletReference data) { }
     private record LocationEnvelope(LocationReference data) { }
     private record TransitionEnvelope(Transition data) { }
 }

lastleg-service/src/main/java/com/baiyue/lastleg/palletops/service/PdaPalletOperationService.java

@@ -367,6 +367,7 @@ public class PdaPalletOperationService {
 
     private PalletPhysicalGateway.PalletReference requirePallet(long warehouseId, String code) {
         PalletPhysicalGateway.PalletReference pallet = physical.resolve(code(code));
+        if (pallet == null) throw notFound("未找到托盘");
         if (pallet.warehouseId() != warehouseId) throw conflict("托盘不属于 Token 冻结的海外仓");
         if ("SCRAPPED".equals(pallet.status())) throw conflict("已报废托盘不能执行作业");
         return pallet;
@@ -517,6 +518,7 @@ public class PdaPalletOperationService {
     private static long value(Long value) { return value == null ? 0L : value; }
     private static ResponseStatusException conflict(String message) { return new ResponseStatusException(HttpStatus.CONFLICT, message); }
     private static ResponseStatusException badRequest(String message) { return new ResponseStatusException(HttpStatus.BAD_REQUEST, message); }
+    private static ResponseStatusException notFound(String message) { return new ResponseStatusException(HttpStatus.NOT_FOUND, message); }
 
     private record PlannedMove(long positionId, long packages, long expectedVersion,
                                long sourcePalletId, String sourcePalletCode,