Grails 3迁移后无法捕获数据库异常问题求助

我之前帮同事处理过一模一样的Grails版本迁移问题，这个数据库异常没冒泡到控制器的情况，本质是Grails 3.1的事务与异常处理机制和2.5版本有很大差异，下面给你拆解原因和可行的解决办法：

Grails 2.5中，控制器动作默认会被事务代理包裹，数据库操作抛出的异常会直接向上传递到控制器层面，最终触发500错误；但到了Grails 3.x，官方调整了设计：

• 控制器默认不再具备事务特性，数据库操作的事务边界被移到了服务层
• GORM的默认异常处理逻辑更“静默”，部分数据库约束异常会被内部处理，不会主动抛到控制器

1. 规范事务边界，把业务逻辑移到服务层 #

Grails 3.x推荐将数据库操作放在服务层（Service）中，服务类默认带有@Transactional注解，异常会正确向上抛出。示例如下：

服务层代码

import grails.transaction.Transactional

class YourDomainService {
    def delete(Long id) {
        YourDomain domain = YourDomain.get(id)
        if (!domain) {
            throw new IllegalArgumentException("记录不存在")
        }
        domain.delete(flush: true) // 这里触发数据库约束时会抛出DataIntegrityViolationException
    }
}

控制器代码

class YourController {
    YourDomainService yourDomainService

    def delete(Long id) {
        try {
            yourDomainService.delete(id)
            redirect(action: "list")
        } catch (DataIntegrityViolationException ex) {
            // 在这里处理异常，比如返回错误提示
            flash.message = "无法删除该记录，因为存在关联数据"
            redirect(action: "show", id: id)
        }
    }
}

2. 给控制器动作手动添加事务注解（不推荐，但适合快速兼容旧代码） #

如果不想重构服务层，也可以直接给控制器的特定动作添加@Transactional注解，让事务边界回到控制器层面，异常就能正常冒泡：

import grails.transaction.Transactional

class YourController {
    @Transactional
    def delete(Long id) {
        YourDomain domain = YourDomain.get(id)
        domain.delete(flush: true)
        // ...其他逻辑
    }
}

3. 配置全局异常捕获，统一处理500错误 #

如果希望沿用旧版的全局异常映射逻辑，可以调整UrlMappings.groovy，针对数据库约束异常做定向处理：

class UrlMappings {
    static mappings = {
        // 其他映射...
        "500"(controller: "error", action: "databaseConstraint") {
            exception = [org.springframework.dao.DataIntegrityViolationException]
        }
        "500"(view: '/error') // 其他500错误的默认处理
    }
}

也可以用Spring的@ControllerAdvice实现更灵活的全局异常处理：

import org.springframework.dao.DataIntegrityViolationException
import org.springframework.web.bind.annotation.ControllerAdvice
import org.springframework.web.bind.annotation.ExceptionHandler
import org.springframework.web.servlet.ModelAndView

@ControllerAdvice
class GlobalExceptionHandler {

    @ExceptionHandler(DataIntegrityViolationException)
    ModelAndView handleDbConstraintException(DataIntegrityViolationException ex) {
        new ModelAndView('error/dbError', [
            errorMessage: "数据库约束冲突：${ex.message}",
            exception: ex
        ])
    }
}

4. 开启GORM的failOnError配置 #

在application.yml中添加以下配置，强制GORM在数据库操作失败时直接抛出异常，而不是静默返回false：

grails:
    gorm:
        failOnError: true

最推荐的方案是把数据库操作移到服务层，既符合Grails 3.x的设计规范，也能更清晰地管理事务和异常；如果是临时兼容旧代码，可以选择给控制器加事务注解或者调整全局异常配置。

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