Spring Boot 实战（三）：Service 分层 + 统一返回 + 异常处理（工程级写法）

tips： 先学习 ioc和di

Spring 核心思想解析：IoC 与 DI 一文讲透（从入门到工程理解）

一、前言

在前两篇中，我们已经完成：

Controller 接口开发
DTO 参数接收
@Valid 参数校验

但当前代码仍然存在明显问题：

Controller 承担了业务逻辑 ❌
返回结构不统一 ❌
没有异常处理 ❌
没有日志 ❌

👉 本篇将完成一次工程级升级

---

二、目标

我们将实现：

Controller → Service 分层 ✔

统一返回结构（Result）✔

统一异常处理 ✔

日志输出 ✔

三、统一返回结构（Result）

创建 Result 类

package org.example.arkbackend.common;

import lombok.Data;

@Data
public class Result<T> {

    private int code;
    private String message;
    private T data;

    public static <T> Result<T> success(T data) {
        Result<T> r = new Result<>();
        r.setCode(0);
        r.setMessage("成功");
        r.setData(data);
        return r;
    }

    public static <T> Result<T> fail(String message) {
        Result<T> r = new Result<>();
        r.setCode(1);
        r.setMessage(message);
        return r;
    }
}

---

👉 返回统一格式：

{
  "code": 0,
  "message": "成功",
  "data": {}
}

四、Service 层设计

1️⃣ 接口

package org.example.arkbackend.service;

import org.example.arkbackend.dto.UserRegisterDTO;

public interface UserService {

    String register(UserRegisterDTO dto);

    String getUserById(Long id);

    void deleteUser(Long id);
}

---

2️⃣ 实现类

package org.example.arkbackend.service.impl;

import lombok.extern.slf4j.Slf4j;
import org.example.arkbackend.dto.UserRegisterDTO;
import org.example.arkbackend.service.UserService;
import org.springframework.stereotype.Service;

@Slf4j
@Service
public class UserServiceImpl implements UserService {

    @Override
    public String register(UserRegisterDTO dto) {

        log.info("开始注册用户：{}", dto.getUsername());

        // 模拟业务逻辑
        if ("admin".equals(dto.getUsername())) {
            throw new RuntimeException("用户名已存在");
        }

        return "注册成功：" + dto.getUsername();
    }

    @Override
    public String getUserById(Long id) {
        log.info("查询用户ID：{}", id);
        return "用户ID：" + id;
    }

    @Override
    public void deleteUser(Long id) {
        log.info("删除用户ID：{}", id);
    }
}

五、Controller 重构

package org.example.arkbackend.controller;

import jakarta.validation.Valid;
import org.example.arkbackend.common.Result;
import org.example.arkbackend.dto.UserRegisterDTO;
import org.example.arkbackend.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserService userService;

    @PostMapping("/register")
    public Result<String> register(@Valid @RequestBody UserRegisterDTO dto) {
        return Result.success(userService.register(dto));
    }

    @GetMapping("/{id}")
    public Result<String> getUser(@PathVariable Long id) {
        return Result.success(userService.getUserById(id));
    }

    @DeleteMapping("/{id}")
    public Result<Void> delete(@PathVariable Long id) {
        userService.deleteUser(id);
        return Result.success(null);
    }
}

---

👉 Controller 现在只负责：

接收参数 + 调用 Service + 返回结果

六、统一异常处理（非常重要）

创建全局异常处理类

package org.example.arkbackend.exception;

import org.example.arkbackend.common.Result;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public Result<?> handleException(Exception e) {
        return Result.fail(e.getMessage());
    }
}

---

👉 当异常发生：

{
  "code": 1,
  "message": "用户名已存在"
}

七、日志（Log）

使用 @Slf4j

@Slf4j

使用方式

log.info("注册用户：{}", username);
log.error("发生异常：{}", e.getMessage());

---

👉 优点：

✔ 可追踪
✔ 可定位问题
✔ 可分析行为

---

八、完整执行流程

请求进入 Controller
→ 参数校验（@Valid）
→ 调用 Service
→ Service 执行业务逻辑
→ 返回 Result
→ 异常统一处理

---

九、当前项目结构

controller/
dto/
service/
service/impl/
common/
exception/

---

👉 已具备：

企业级基础架构 ✔

---

十、一句话总结

通过 Service 分层、统一返回结构和全局异常处理，可以将简单接口升级为具备工程规范的后端系统

---

下一篇：

Spring Boot 实战（四）：MySQL + MyBatis 接入，打通用户注册最小闭环

数据库（MySQL） + 持久层（Mapper / JPA）

👉 实现真实数据存储