JHipster：保存实体时如何处理SQL异常并在AngularJS前端展示

我来帮你梳理下在JHipster里处理这类数据库异常的完整流程，从后端捕获、转换友好消息，到前端接收并展示，一步一步来：

一、后端：捕获并转换SQL异常 #

JHipster基于Spring Boot，咱们可以利用Spring的全局异常处理机制来统一处理DataIntegrityViolationException这类数据库异常，避免直接把晦涩的SQL错误返回给前端。

1. 自定义全局异常处理器 #

创建一个全局异常处理类，用@RestControllerAdvice注解，专门捕获数据库相关的异常：

import org.springframework.dao.DataIntegrityViolationException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class CustomExceptionHandler {

    @ExceptionHandler(DataIntegrityViolationException.class)
    public ResponseEntity<ErrorResponse> handleDataIntegrityViolation(DataIntegrityViolationException ex) {
        String errorMessage = resolveFriendlyMessage(ex);
        ErrorResponse errorResponse = new ErrorResponse(HttpStatus.CONFLICT.value(), errorMessage);
        return new ResponseEntity<>(errorResponse, HttpStatus.CONFLICT);
    }

    // 解析异常，转换成用户友好的消息
    private String resolveFriendlyMessage(DataIntegrityViolationException ex) {
        // 这里可以根据具体的异常原因做判断，比如唯一键冲突、外键约束等
        String message = ex.getRootCause().getMessage();
        if (message.contains("UK_username")) { // 假设你的唯一键约束名是UK_username
            return "该用户名已被注册，请更换其他用户名";
        } else if (message.contains("FK_employee_department")) { // 外键约束
            return "无法删除该部门，因为还有员工关联到它";
        } else {
            return "数据保存失败，请检查输入是否符合要求";
        }
    }

    // 定义错误响应的DTO
    public static class ErrorResponse {
        private int status;
        private String message;

        // 构造器、getter、setter
        public ErrorResponse(int status, String message) {
            this.status = status;
            this.message = message;
        }

        public int getStatus() { return status; }
        public String getMessage() { return message; }
    }
}

2. 注意事项 #

• 要根据你数据库里的约束名称（比如唯一键、外键的命名）来匹配判断，这样返回的消息更精准。
• 如果JHipster已经自带了全局异常处理类（比如ExceptionTranslator），你也可以直接在这个类里扩展handleDataIntegrityViolation方法，不用新建类。

二、前端：捕获错误并展示到页面 #

JHipster的AngularJS前端通常用$resource或者$http来调用后端接口，咱们只需要在实体保存的方法里处理错误回调，把后端返回的友好消息展示给用户。

1. 在实体Controller中处理保存错误 #

比如你的用户实体Controller里，保存方法可以这么写：

(function() {
    'use strict';

    angular
        .module('myApp')
        .controller('UserController', UserController);

    UserController.$inject = ['User', '$state', 'alertService'];

    function UserController(User, $state, alertService) {
        var vm = this;
        vm.user = {};

        vm.save = function() {
            if (vm.user.id !== null) {
                User.update(vm.user, onSaveSuccess, onSaveError);
            } else {
                User.save(vm.user, onSaveSuccess, onSaveError);
            }
        };

        function onSaveSuccess(result) {
            alertService.success('用户保存成功！');
            $state.go('user-detail', {id: result.id});
        }

        function onSaveError(error) {
            // 从后端返回的错误响应中提取消息
            var errorMessage = error.data.message || '保存失败，请稍后重试';
            alertService.error(errorMessage);
        }
    }
})();

2. 利用JHipster自带的alertService #

JHipster默认提供了alertService，可以直接用它来展示错误消息（会在页面顶部弹出提示框），不用自己写弹窗组件。如果需要自定义样式，也可以修改alertService的实现或者替换成你自己的组件。

三、额外提示 #

• 如果你想更细致地处理不同类型的SQL异常，可以进一步解析DataIntegrityViolationException的SQLState，比如SQLState 23000就是完整性约束违反，不同的子状态对应不同的错误类型。
• 后端返回的状态码建议用409 Conflict（冲突）来表示唯一键这类问题，比通用的400更语义化。

内容的提问来源于stack exchange，提问作者Abdoul Karim SAVADOGO