Grails 3.3.9 + Spring Security UI 3.1.2 注册重复邮箱错误提示异常

你目前遇到的提示差异本质是错误绑定链路不统一：

• 重复用户名的提示，是项目自定义的字段级错误，没有走到全局异常兜底流程，所以能被页面的错误渲染组件捕获，生成对应样式的<span class='s2ui_error'>标签
• 重复邮箱的场景，是直接触发了数据库层面的唯一索引冲突，这个异常被全局拦截器捕获后返回了通用提示，根本没有把错误绑定到对应的email字段上，自然没法生成字段级的错误提示

注：GORM定义的unique: true约束本身是支持产出字段级错误的，出现这个问题不是约束配置的问题，是流程链路的断点导致的

1. 定位现有自定义用户名校验的逻辑 #

• 全局检索固定提示文本The username is taken，找到对应的业务代码位置
• 该逻辑大概率是在注册提交的Controller方法中，手动查询库内已存在的同名用户，通过errors.rejectValue()方法把错误绑定到User对象的username字段上，最终被页面的通用字段错误渲染组件识别展示

2. 打通邮箱字段的错误绑定链路 #

• 首先定位全局异常捕获逻辑：一般是Controller层的@ExceptionHandler配置或者请求拦截器，找到抛出通用黑底提示sorry there was a problem processing your registration的代码位置，确认该逻辑是捕获到数据库唯一索引冲突的DataIntegrityViolationException后直接返回兜底提示
• 出现这个兜底提示的核心原因是：程序没有在写入数据库前提前触发GORM的unique校验，直接执行了save操作触发表层面的唯一索引冲突，异常被全局拦截器直接接管，跳过了字段错误绑定流程
• 对应修正方案二选一即可：
  • 方案A：在调用save()方法前，手动触发User对象的全量校验（调用user.validate()），让GORM提前执行email字段的unique约束校验，只要校验不通过，错误会自动绑定到email字段上，和其他约束错误（比如邮箱格式不对、内容为空）走完全一样的渲染流程
  • 方案B：修改全局异常捕获逻辑，捕获到唯一索引冲突的异常时，判断冲突字段对应的是email列，就把对应的提示错误重新绑定到模型的email字段上，返回注册页面走正常的字段错误渲染，而不是直接弹出通用提示

3. 验证渲染链路匹配 #

• 确认页面上email输入框对应的错误渲染逻辑，和username输入框使用的是同一套生成<span class='s2ui_error'>的自定义标签组件，没有单独给email配置不同的渲染规则
• 可通过临时测试验证：在注册Controller中手动写入测试代码user.errors.rejectValue('email', 'user.email.unique', '该邮箱已被注册')，跳回注册页面查看，只要能正常生成带s2ui_error类的错误标签，就说明渲染链路没有问题，剩余问题只需要修正前面的错误捕获流程即可

常见踩坑点：如果校验触发时机不对，比如其他字段的校验错误导致提前返回，email的unique校验没有被执行，就会出现你提到的“通用提示仅在没有其他校验错误时才会触发”的现象——因为有其他校验错误时，流程根本走不到save步骤，也就不会触发数据库层面的唯一索引冲突。

内容的提问来源于stack exchange，提问作者MonetsChemist