Spring Boot后端开发 8 大核心生产级代码模板

 更新时间:2026年09月11日 09:00:40   作者:漫漫长路  
这篇文章主要介绍了SpringBoot后端开发8大核心生产级代码模板,本文结合实例代码给大家介绍的非常详细,需要的朋友可以参考下

1. 全局异常处理 —— 相当于“服务员的统一微笑回复”

  • 大白话:后厨做菜(代码运行)难免会出错(比如盘子摔碎了、没食材了)。如果没有这个,用户就会直接在屏幕上看到一大堆看不懂的黑底白字报错信息(像把后厨骂人的脏话展示给顾客了)。
  • 代码干了啥:不管后厨出了啥幺蛾子,服务员统一拦截下来,微笑着对顾客说:“对不起,系统繁忙,请稍后再试”,格式非常整齐。
// 1. 统一给顾客看的“打包盒”
public record Result<T>(int code, String message, T data) {
    public static <T> Result<T> success(T data) {
        return new Result<>(200, "成功", data);
    }
    public static <T> Result<T> fail(String msg) {
        return new Result<>(500, msg, null);
    }
}
// 2. 兜底的服务员(拦截所有报错)
@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public Result<Void> handleException(Exception e) {
        // 偷偷把错误记录在后台日志里,但给顾客返回礼貌提示
        return Result.fail("系统出了一点小问题,请稍后重试");
    }
}

2. Redisson 分布式锁 —— 相当于“试衣间锁门”

  • 大白话:试衣间(共享资源,比如最后 1 件衣服)只有一间。100 个人同时来抢,怎么办?谁先抢到门把手,谁就把门锁上(tryLock)。其他人只能在门口等着。里面的人试完出来,把门锁打开(unlock),下一个才能进去。
  • 代码干了啥:防止几百个人同时修改同一个数据导致数据错乱。
@Service
@RequiredArgsConstructor
public class SeckillService {
    private final RedissonClient redissonClient;
    public void buyProduct(String productId) {
        RLock lock = redissonClient.getLock("lock:" + productId);
        try {
            // 尝试拿锁:最多等 3 秒,拿到后锁 10 秒
            if (lock.tryLock(3, 10, TimeUnit.SECONDS)) {
                try {
                    // 锁门成功!安心在这里处理买东西的逻辑
                } finally {
                    // 试完了,必须把门锁解开,让给别人
                    if (lock.isHeldByCurrentThread()) {
                        lock.unlock();
                    }
                }
            } else {
                // 等了 3 秒还没门开,直接告诉顾客“没抢到”
            }
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }
}

3. MQ 消息手动确认(ACK)—— 相当于“快递签收单”

  • 大白话:快递员给你送货(消息队列给你发任务)。如果是“自动确认”,快递员扔到门口就走,万一被偷了你就亏了。如果是“手动确认(ACK)”,你必须亲自把包裹拆开验完货(业务处理成功),再在签收单上签字(basicAck)。如果发现货坏了,你拒签(basicNack),让快递员拿回去重新处理。
  • 代码干了啥:保证消息绝对不会因为程序突然断电、崩溃而丢失。
@Component
public class MQConsumer {
    @RabbitListener(queues = "order.queue", ackMode = "MANUAL")
    public void receiveOrder(String message, Channel channel, @Header(AmqpHeaders.DELIVERY_TAG) long tag) throws IOException {
        try {
            // 1. 拆快递、验货、处理业务
            System.out.println("收到订单消息:" + message);
            // 2. 确认无误,签名签收!(告诉 MQ 可以把这条消息删了)
            channel.basicAck(tag, false);
        } catch (Exception e) {
            // 3. 出错了!拒签,退回给快递公司重新送
            channel.basicNack(tag, false, false);
        }
    }
}

4. 自定义线程池 —— 相当于“招募固定数量的厨师”

  • 大白话:如果每来一个顾客你就临时招一个厨师(new Thread()),顾客太多时,厨房会挤爆(内存溢出 OOM)。科学做法是:雇 10 个干活的厨师(核心线程),准备一个可以排 200 人的等候区(阻塞队列)。如果等候区也满了,多余的顾客让店长亲自去接待(拒绝策略)。
  • 代码干了啥:控制系统的并发干活人数,防止把服务器卡死。
@Configuration
public class ThreadPoolConfig {
    @Bean("myThreadPool")
    public ThreadPoolTaskExecutor myThreadPool() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(10);                  // 常驻厨师:10 人
        executor.setMaxPoolSize(20);                   // 忙不过来时最多扩到:20 人
        executor.setQueueCapacity(200);                // 休息区桌子:200 张
        executor.setThreadNamePrefix("my-worker-");   // 给厨师衣服贴工号
        // 人实在装不下了,让来派任务的主线程自己去干
        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        executor.initialize();
        return executor;
    }
}

5. Redis + Lua 脚本预扣库存 —— 相当于“黑板刷秒杀法”

  • 大白话:秒杀开始时,10 万人冲进来查数据库,数据库直接瘫痪。怎么办?把商品数量(比如 100 件)提前写在黑板(内存 Redis)上。来一个人,直接在黑板上擦掉一个数(decrby)。黑板擦到 0 了,后面的人连看都不用看数据库,直接提示“售罄”。
  • 代码干了啥:把最耗时、最怕并发的检查,全在极速的内存里搞定。
@Service
@RequiredArgsConstructor
public class StockService {
    private final StringRedisTemplate redisTemplate;
    // Lua 脚本:在 Redis 内部完成“检查库存 -> 扣减库存”,一体化搞定
    private static final String SCRIPT = 
        "local stock = tonumber(redis.call('get', KEYS[1])); " +
        "if stock and stock > 0 then " +
        "    redis.call('decrby', KEYS[1], 1); " +
        "    return 1; " + // 扣减成功
        "end; " +
        "return 0;"; // 没库存了
    public boolean buy(String stockKey) {
        DefaultRedisScript<Long> redisScript = new DefaultRedisScript<>(SCRIPT, Long.class);
        Long result = redisTemplate.execute(redisScript, Collections.singletonList(stockKey));
        return Long.valueOf(1).equals(result);
    }
}

6. 接口限流 —— 相当于“酒吧门口的保镖”

  • 大白话:有人恶意用软件一秒钟刷你接口 10000 次,服务器马上就要崩。限流就像门口的保镖:规定 1 分钟内,同一个人最多只能进去 10 次。第 11 次直接一巴掌踢飞:“刷太快了,等会再来!”
  • 代码干了啥:用切面(AOP)加上 Redis 计数,无侵入地拦截恶意恶刷。
// 1. 自定义标签:贴在方法上就能限流
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface RateLimit {
    int maxCount() default 10; // 最多进 10 次
    int second() default 60;   // 60 秒内
}
// 2. 门口的保镖(切面)
@Aspect
@Component
@RequiredArgsConstructor
public class RateLimitAspect {
    private final StringRedisTemplate redisTemplate;
    @Around("@annotation(limit)")
    public Object intercept(ProceedingJoinPoint pjp, RateLimit limit) throws Throwable {
        String key = "limit:" + pjp.getSignature().toShortString();
        Long count = redisTemplate.opsForValue().increment(key);
        if (count != null && count == 1) {
            redisTemplate.expire(key, Duration.ofSeconds(limit.second()));
        }
        if (count != null && count > limit.maxCount()) {
            throw new RuntimeException("你刷得太快了,休息一下吧!");
        }
        return pjp.proceed(); // 放行,让他进去
    }
}

7. MyBatis-Plus 分页查询 —— 相当于“看书一页一页翻”

  • 大白话:如果你的字典(数据库)有 100 万页,你不能把整本书一口气塞给用户看,那会把人的头撑爆(内存溢出)。正确做法是告诉数据库:“我只要第 1 页,一页放 10 条数据”。
  • 代码干了啥:让数据库只返回当页的数据(SQL 里的 LIMIT),既快又省内存。
@Service
@RequiredArgsConstructor
public class OrderService {
    private final OrderMapper orderMapper;
    public Page<Order> getOrders(Long userId, int pageNum, int pageSize) {
        // 1. 我要第 pageNum 页,每页 pageSize 条
        Page<Order> page = new Page<>(pageNum, pageSize);
        // 2. 查询条件:查 userId 是这个人的订单,按时间倒序排
        LambdaQueryWrapper<Order> wrapper = new LambdaQueryWrapper<Order>()
                .eq(Order::getUserId, userId)
                .orderByDesc(Order::getCreateTime);
        // 3. 查数据库,只拿这 10 条出来
        return orderMapper.selectPage(page, wrapper);
    }
}

8. RestTemplate 设置超时 —— 相当于“打电话设定最长等待时间”

  • 大白话:你给第三方(比如微信支付、快递查询 API)打电话(发 HTTP 请求)。如果对方系统挂了、一直不接电话,你不能傻傻地举着电话等一辈子(占用系统资源)。你必须设定:响铃 3 秒不接(连接超时)或者 5 秒不说话(读取超时),立刻挂断!
  • 代码干了啥:保护自己,不被调用的外部系统拖垮。
@Configuration
public class RestConfig {
    @Bean
    public RestTemplate restTemplate(RestTemplateBuilder builder) {
        return builder
                .setConnectTimeout(Duration.ofSeconds(3)) // 等响应建立最多 3 秒
                .setReadTimeout(Duration.ofSeconds(5))    // 等对方传数据最多 5 秒
                .build();
    }
}
// 调用第三方接口
@Service
@RequiredArgsConstructor
public class RemoteCallService {
    private final RestTemplate restTemplate;
    public String callOtherSystem() {
        // 超过时间没反应会直接抛异常挂断,绝对不傻等
        return restTemplate.getForObject("https://api.example.com/data", String.class);
    }
}

还差哪 20% 才能彻底搞定工作与面试?

这 8 个场景帮你封顶了“业务开发”与“高并发”的主干,如果你想做到 100% 稳妥,只需要补齐以下两块:

  • 数据库层面的调优(MySQL)
    • 工作/面试重点: 慢 SQL 优化、索引失效场景(如最左前缀法则)、事务隔离级别与 MVCC 机制。
  • 线上问题的排查工具与指令(Linux / JVM)
    • 工作/面试重点: 当服务器 CPU 飙到 100% 或内存溢出时,怎么用 top、jstack、jmap 找到是哪行代码出的问题。

到此这篇关于Spring Boot后端开发 8 大核心生产级代码模板的文章就介绍到这了,更多相关Spring Boot 生产级代码模板内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

最新评论