diff --git a/platform-app/src/main/resources/application.yml b/platform-app/src/main/resources/application.yml
index a7715f2..842a3cc 100644
--- a/platform-app/src/main/resources/application.yml
+++ b/platform-app/src/main/resources/application.yml
@@ -10,9 +10,15 @@ spring:
username: ceshi
password: ceshi
hikari:
- maximum-pool-size: 5
+ # 基础默认池(总览 §10.2)。default/prod profile 无独立 yml 时继承本值;
+ # dev/local 各自覆盖为更小值。生产高负载可经独立 prod profile 或环境进一步上调。
+ maximum-pool-size: 20
# PoC 阶段对共享测试库默认只读,对拍写操作需显式改 false
read-only: false
+ # 慢查询熔断(总览 §10.2):杀死单条运行超时的 SQL,防失控/恶意查询(如超大 perPage 全表扫)
+ # 长期占用连接、与小池叠加拖垮实例。会话级,随连接复用持续生效;dev/local 继承本项。
+ # 默认 120s 对 OLTP 足够宽,重报表/批量场景经环境变量放宽,设 0 关闭。
+ connection-init-sql: "SET statement_timeout = '${EIP4_DB_STATEMENT_TIMEOUT:120s}'"
server:
port: 8084
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/FlowController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/FlowController.java
index 1b43c0d..f358566 100644
--- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/FlowController.java
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/FlowController.java
@@ -300,7 +300,8 @@ public class FlowController {
return;
}
int page = parsePositiveInt(map.remove("page"), 1);
- int perPage = parsePositiveInt(map.remove("perPage"), DEFAULT_PER_PAGE);
+ // perPage 封顶(总览 §10.2):防 perPage=999999 一次物化全表致 OOM/连接耗尽;page 不封(深翻页合法)
+ int perPage = Pagination.clampPerPage(parsePositiveInt(map.remove("perPage"), DEFAULT_PER_PAGE));
map.put(POJOCRUDService.PAGE_START, (page - 1) * perPage);
map.put(POJOCRUDService.PAGE_SIZE, perPage);
}
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/Pagination.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/Pagination.java
new file mode 100644
index 0000000..62f6b5c
--- /dev/null
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/Pagination.java
@@ -0,0 +1,25 @@
+package com.eip4.platform.metadata.web;
+
+/**
+ * 分页参数安全护栏(总览 §10.2 稳定性)。
+ *
+ *
仅作「安全上限」用途——防止客户端传 {@code perPage=999999} 让引擎一次把全表物化进内存,
+ * 与小连接池叠加即可单请求耗尽连接 / OOM。这不是产品级分页上限:
+ * 交互式大数据集应走服务端搜索({@code q});超大导出应走流式通道(未来工作)。
+ */
+final class Pagination {
+
+ /** 每页条数硬上限:远超任何真实页大小(amis 默认 10 / picker 20),远低于 OOM 阈值。 */
+ static final int MAX_PER_PAGE = 5000;
+
+ private Pagination() {
+ }
+
+ /** 把每页条数夹到 {@code [1, MAX_PER_PAGE]};用于所有 REST 分页入口。 */
+ static int clampPerPage(int perPage) {
+ if (perPage > MAX_PER_PAGE) {
+ return MAX_PER_PAGE;
+ }
+ return Math.max(perPage, 1);
+ }
+}
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
index 1a06b8c..d423527 100644
--- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
@@ -174,8 +174,10 @@ public class PickerController {
: buildCtx(asUser, roles, asDepart, asOrg);
Map cond = new HashMap<>();
- cond.put(POJOCRUDService.PAGE_START, (page - 1) * perPage);
- cond.put(POJOCRUDService.PAGE_SIZE, perPage);
+ // perPage 封顶(总览 §10.2):防客户端传超大 perPage 一次拉全表致 OOM/连接耗尽
+ int safePerPage = Pagination.clampPerPage(perPage);
+ cond.put(POJOCRUDService.PAGE_START, (page - 1) * safePerPage);
+ cond.put(POJOCRUDService.PAGE_SIZE, safePerPage);
// 模糊搜索:仅当有关键字且存在可读标识列时下推 LIKE。q 经转义后进引擎(引擎对 String 条件裸拼
// col like '%值%',转义单引号与 LIKE 通配符,杜绝注入与通配符逃逸)。标识列名本身来自元数据,天然合法。
if (q != null && !q.isBlank() && labelColumn != null) {
diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/FlowControllerTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/FlowControllerTest.java
index 2aee45b..cf5ebcc 100644
--- a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/FlowControllerTest.java
+++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/FlowControllerTest.java
@@ -616,6 +616,26 @@ class FlowControllerTest {
assertEquals("放假", sent.get("TITLE"), "其它 query 参数仍作过滤条件保留");
}
+ @Test
+ @DisplayName("14. perPage 超大封顶: 防一次拉全表致 OOM/连接耗尽(总览 §10.2)")
+ void clampsExcessivePerPage() {
+ String flowId = "PM_PROJECT_SEARCH";
+ FlowExcuteService engine = mock(FlowExcuteService.class);
+ when(engine.excute(any(), any(), any())).thenReturn(new HashMap<>());
+ FlowController controller = new FlowController(engine, resolverReturning(flowId, synthesized(flowId)));
+
+ Map params = new HashMap<>();
+ params.put("perPage", "999999"); // 恶意/失误的超大每页
+ controller.executeGet(flowId, params);
+
+ @SuppressWarnings("unchecked")
+ ArgumentCaptor