✨ 应收账单预览支持大批量单号查询

bms-back/bms-system/src/main/java/com/bms/ar/service/impl/ArBillServiceImpl.java

@@ -135,7 +135,10 @@ public class ArBillServiceImpl implements IArBillService {
     private static final int EXPLICIT_SOURCE_ID_LIMIT = 10000;
     private static final int EXCLUDED_SOURCE_ID_LIMIT = 10000;
     /** 单次生成查询最多接收的订单号、运单号或转单号数量。 */
-    private static final int ORDER_IDENTIFIER_LIMIT = 2000;
+    private static final int ORDER_IDENTIFIER_LIMIT = 20000;
+    /** 订单号会分别匹配订单号、运单号和转单号列；预留其他 SQL 参数空间后控制 MySQL 参数总数。 */
+    private static final int ORDER_IDENTIFIER_SQL_BIND_COUNT = 3;
+    private static final int MAX_SQL_PARAMETER_COUNT = 65000;
     /**
      * 模板明细行使用的边框、字体和换行样式；样式定义来自 ar_bill_template.xlsx。
      */
@@ -351,6 +354,9 @@ public class ArBillServiceImpl implements IArBillService {
             throw new ServiceException("全选模式最多排除 " + EXCLUDED_SOURCE_ID_LIMIT
                     + " 条订单，请缩小查询条件后再生成");
         }
+        validateOrderIdentifierParameterCount(
+                normalizeOrderIdentifiers(request.getOrderOrTrackingNo()).size(),
+                allMatched ? excludedSourceBillIds.size() : sourceBillIds.size());
         request.setSelectionMode(selectionMode);
 
         String currency = StringUtils.isEmpty(request.getCurrency()) ? "CNY" : request.getCurrency().trim();
@@ -1990,6 +1996,12 @@ public class ArBillServiceImpl implements IArBillService {
                 || query.getBillPeriodEnd() == null) {
             throw new ServiceException("客户和账单截止日不能为空");
         }
+        int identifierCount = normalizeOrderIdentifiers(query.getOrderOrTrackingNo()).size()
+                + normalizeOrderIdentifiers(query.getExcludeOrderOrTrackingNo()).size();
+        if (identifierCount > ORDER_IDENTIFIER_LIMIT) {
+            throw new ServiceException("筛选单号和排除单号合计最多输入 " + ORDER_IDENTIFIER_LIMIT + " 个");
+        }
+        validateOrderIdentifierParameterCount(identifierCount, 0);
     }
 
     /** 可参与本次应收生成的订单状态；PARTIAL 只生成其中仍为 UNBILLED 的费用。 */
@@ -2041,6 +2053,14 @@ public class ArBillServiceImpl implements IArBillService {
         return new ArrayList<>(uniqueIdentifiers);
     }
 
+    /** 校验重复用于三列精确匹配的单号参数及选择/排除订单 ID 不会超过数据库参数预算。 */
+    private void validateOrderIdentifierParameterCount(int orderIdentifierCount, int billIdCount) {
+        long parameterCount = (long) orderIdentifierCount * ORDER_IDENTIFIER_SQL_BIND_COUNT + billIdCount;
+        if (parameterCount > MAX_SQL_PARAMETER_COUNT) {
+            throw new ServiceException("单号筛选与订单选择/排除条件过多，请减少单号或选择/排除订单数量后重试");
+        }
+    }
+
     private long elapsedMillis(long startedAt) {
         return (System.nanoTime() - startedAt) / 1_000_000L;
     }