// Package verr 收集式校验错误(报错一次收全 + 每条带怎么办,2026-10-20 拍板): // 校验函数从「发现错就 return」改为逐条收集,收尾用 OrNil() 一次性返回全部问题, // 由 handler 层 FailErr 识别后输出 code=3015 + data.errors 结构化响应, // 前端拦截器识别后用 ErrorListDialog 一次弹全,不再挤牙膏。 package verr import "fmt" // ErrAction 可跳转动作:前端渲染为按钮,点击新开标签页跳转 URL(当前页表单草稿保留)。 type ErrAction struct { Label string `json:"label"` URL string `json:"url"` } // FieldError 单条校验错误:现象(Message)+ 怎么办(Suggestion)+ 可选跳转(Action)。 type FieldError struct { Field string `json:"field"` Message string `json:"message"` Suggestion string `json:"suggestion"` Action *ErrAction `json:"action,omitempty"` } // ValidationError 收集容器:errors 非空时整体作为一个 error 返回。 type ValidationError struct { Errors []FieldError } // New 新建收集器。 func New() *ValidationError { return &ValidationError{} } // Add 追加一条「现象 + 怎么办」。 func (e *ValidationError) Add(field, message, suggestion string) { e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion}) } // AddAction 追加一条带跳转按钮的错误(label=按钮文案,url=新标签页打开的路由)。 func (e *ValidationError) AddAction(field, message, suggestion, label, url string) { e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion, Action: &ErrAction{Label: label, URL: url}}) } // Merge 把另一个收集器的条目并入本收集器。 func (e *ValidationError) Merge(o *ValidationError) { if o != nil && len(o.Errors) > 0 { e.Errors = append(e.Errors, o.Errors...) } } // Len 已收集条数。 func (e *ValidationError) Len() int { if e == nil { return 0 } return len(e.Errors) } // OrNil 收尾:无错误返回 nil,有错误返回自身(校验函数统一调用)。 func (e *ValidationError) OrNil() error { if e == nil || len(e.Errors) == 0 { return nil } return e } func (e *ValidationError) Error() string { return fmt.Sprintf("保存失败,共 %d 项需要处理", len(e.Errors)) }