singleField = items.get(2);
+ assertEquals("input-file", singleField.get("type"));
+ assertEquals("/api/file/upload", singleField.get("receiver"));
+ assertNull(singleField.get("multiple"));
+
+ // 映射台账中有 input-file 记录
+ assertTrue(notes.stream().anyMatch(n -> n.contains("input-file")));
+ }
+
// ── tree ─────────────────────────────────────────────────────────────
@Test
diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/WriteExceptionHandler.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/WriteExceptionHandler.java
new file mode 100644
index 0000000..45176c4
--- /dev/null
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/WriteExceptionHandler.java
@@ -0,0 +1,83 @@
+package com.eip4.platform.metadata.web;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import com.dsasp.server.common.exception.PrivilegeException;
+import com.dsasp.server.common.exception.ValidationException;
+
+/**
+ * F2-8 写链路异常 → amis 友好响应。
+ *
+ * 拦截 EntityWriteController / FileController 抛出的业务异常,
+ * 转换成 amis 约定格式,避免 Spring 默认 500 裸 JSON 透传前端。
+ *
+ *
+ * - {@link ValidationException} — 业务校验失败(必填/重复/约束等)→
+ * HTTP 422 + {@code {status:422, msg}} (amis form 默认对 status≠0 显示顶部错误提示)
+ * - {@link PrivilegeException} — 数据权限拒绝 →
+ * HTTP 403 + {@code {status:403, msg}}
+ *
+ *
+ * 纪律:零改 {@code com.dsasp};不依赖 Spring Validation(引擎校验经 ValidationException 抛出)。
+ */
+@RestControllerAdvice(assignableTypes = {EntityWriteController.class, FileController.class})
+public class WriteExceptionHandler {
+
+ /**
+ * 业务校验失败(引擎 ValidationException)→ HTTP 422 amis 格式。
+ *
+ *
amis form 约定:{@code status≠0} 时显示顶部错误提示({@code msg} 字段);
+ * 若需字段级行内错误则需 {@code status:422, errors:{fieldName:msg}},
+ * 但引擎 ValidationException 消息不含字段名(如"分类是必填项"),
+ * 故只返回 msg,amis form 会在顶部 toast/alert 区显示。
+ */
+ @ExceptionHandler(ValidationException.class)
+ public ResponseEntity