写流 QA:gracefulFlowError 透出业务校验消息 + 内部错误记栈(dogfooding 修)

逐流写 dogfooding(76 ADD 流采样:~76% 校验健康/3 NPE/1 SQL 语法/3 脚本错)发现系统性 UX 缺陷:
gracefulFlowError 把真实异常消息整体替换成泛化「数据查询失败(数据源可能不可用)」,致:
- 写流用户缺必填项时只见「数据源不可用」而非「单号必填」(校验反馈被屏蔽)
- NPE 仅 log ex.getMessage()(=null)不记栈 → 黑盒不可诊断

修:businessMessage 沿 cause 链取保真层业务异常(Validation/Privilege/SameCode,消息面向用户)
透出;其余内部错误(NPE/SQL/脚本)保留泛化提示但 log 完整栈(可诊断,不泄露内部)。
按 simpleName 匹配避免硬依赖。FlowControllerTest +1(27 全绿)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-14 00:20:45 +08:00
parent 89686005f0
commit 03065d799c
2 changed files with 56 additions and 2 deletions

View File

@@ -6,6 +6,7 @@ import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Properties;
import java.util.Set;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@@ -139,14 +140,48 @@ public class FlowController {
* 写流的事务回滚在引擎 @Transactional 边界已完成(异常已逸出引擎方法),此处仅兜响应,不影响回滚。
*/
private static ResponseEntity<Map<String, Object>> gracefulFlowError(String id, RuntimeException ex) {
log.warn("[FLOW] 执行异常 id={}: {}", sanitize(id), ex.getMessage());
String bizMsg = businessMessage(ex);
String msg;
if (bizMsg != null) {
// 业务/校验异常:消息本就面向最终用户(如「单号必填」),透出——修复写流校验反馈被
// 泛化「数据查询失败」整体屏蔽的缺陷(QA dogfooding 发现:用户缺必填项却只见「数据源不可用」)。
log.warn("[FLOW] 业务校验拦截 id={}: {}", sanitize(id), bizMsg);
msg = bizMsg;
} else {
// 内部错误(NPE/SQL/脚本等):消息可能含内部细节,不透出;但记完整栈以便诊断
// (原仅记 ex.getMessage(),NPE 的 message=null → 黑盒不可排查)。
log.warn("[FLOW] 执行异常 id={}(内部错误,栈如下)", sanitize(id), ex);
msg = "数据查询失败(数据源可能不可用): " + sanitize(id);
}
Map<String, Object> err = new LinkedHashMap<>();
err.put("status", 1);
err.put("msg", "数据查询失败(数据源可能不可用): " + sanitize(id));
err.put("msg", msg);
err.put("data", new LinkedHashMap<>());
return ResponseEntity.ok(err);
}
/** 业务/校验异常类名(消息面向用户,可安全透出);其它(SQL/NPE/脚本)消息不透出以免泄露内部。 */
private static final Set<String> BUSINESS_EX_NAMES = Set.of(
"ValidationException", "PrivilegeException", "SameCodeException");
/**
* 沿 cause 链找首个业务异常(保真层 com.dsasp.server.common.exception.*)的非空消息——
* 这类消息是设计给最终用户看的(如「单号必填」/「无权限」/「编码重复」),可安全透出;
* NPE/SQL/脚本等内部异常返回 null(由调用方兜泛化提示 + 记栈)。按 simpleName 匹配避免硬依赖。
*/
static String businessMessage(Throwable t) {
int guard = 0;
while (t != null && guard++ < 20) {
String m = t.getMessage();
if (BUSINESS_EX_NAMES.contains(t.getClass().getSimpleName())
&& m != null && !m.isBlank()) {
return m.trim();
}
t = t.getCause();
}
return null;
}
/**
* 把 amis crud 的字面分页参数 {@code page}/{@code perPage} 翻译成合成搜索流引擎
* ({@code POJOCRUDService.listSelect})认得的分页键 {@link POJOCRUDService#PAGE_START}/