码客日记-CSDN博客

原创 Spring Boot 接口日志统一打印方案

本文提供的Spring Boot接口日志统一打印方案，通过AOP切面实现接口日志的统一拦截与打印，无需侵入业务代码；通过规范的日志级别配置，避免无效日志冗余；通过日志按天分割，解决单个日志文件过大的问题，三者结合形成一套完整的日志管理方案。核心优势：代码无侵入、日志规范统一、排查效率高、适配线上环境，可直接应用于实际项目，无需过多修改。实施该方案后，线上接口出现问题时，可快速通过日志定位请求参数、响应结果、接口耗时和异常原因，大幅降低问题排查成本，提升项目的可维护性和稳定性。

2026-04-17 14:46:32 323

原创 Spring Boot 参数校验全局处理（JSR380 + 自定义校验）

JSR380提供的默认注解，只能满足基础的参数校验场景，而在实际开发中，经常会遇到一些特殊的校验需求（如手机号格式、身份证号、邮政编码等），此时@Pattern注解虽然可以实现，但正则表达式分散在各个字段上，无法复用，且代码可读性差。通过自定义校验注解，可将特殊的校验逻辑封装起来，实现校验逻辑的复用，同时让代码更简洁、更规范。下面以“手机号格式校验”为例，详细讲解自定义校验注解的实现步骤，其他特殊场景可参考此步骤仿写。

2026-03-29 17:27:26 559

原创 Spring Boot 实战：从0到1搭建简单管理后台

本文专为Spring Boot新手量身打造，全程剔除所有导包代码，聚焦核心实操步骤，用详实的文字描述补充每一步的细节的逻辑，让新手不仅能复制代码运行，还能理解每一步的意义，快速搭建出可落地、可扩展的简单管理后台。教程兼顾简洁性和实用性，不冗余、不堆砌，重点补充操作说明、逻辑讲解和避坑细节，确保即使是刚接触Spring Boot的开发者，也能跟着一步步完成搭建，最终实现完整的用户管理、角色菜单管理等核心功能。

2026-03-21 21:05:50 680

原创 Spring Boot 缓存优化：Redis 实战

本文承接项目数据量大后的性能优化需求，完整实战了Spring Boot集成Redis缓存的核心流程，从环境搭建、缓存注解使用，到热点数据缓存案例，帮你快速落地缓存优化，核心要点总结：集成Redis：引入核心依赖，配置Redis连接信息和序列化方式，开启缓存功能（@EnableCaching），确保Redis环境可用；核心注解：@Cacheable实现查询缓存，减少数据库查询；@CacheEvict实现缓存删除，避免脏数据，两个注解覆盖大多数缓存场景；

2026-03-16 16:40:58 842

原创 Spring Boot 定时任务与异步处理

本文承接项目核心功能完善后的需求，完整实战了Spring Boot定时任务（@Scheduled）与异步处理（@Async）的核心用法，结合定时清理冗余数据、异步发送邮件等真实案例，帮你实现项目自动化，提升项目实用性和性能，核心要点总结：定时任务（@Scheduled）：通过3种方式（固定延迟、固定速率、Cron表达式）实现自动化任务，适配不同定时场景，核心是@EnableScheduling注解开启功能；

2026-03-12 16:30:41 717

原创 Spring Boot + EasyExcel 实现 Excel 导入导出（实战篇）

*** EasyExcel 导入监听器（处理Excel解析后的每一行数据）* 说明：监听器不能被Spring管理，需手动new，因此通过构造方法传入Service// 批量入库阈值（每100条数据批量插入一次，可调整） private static final int BATCH_SIZE = 100;// 存储解析后的Excel数据 private List < ExcelUserDTO > userList = new ArrayList < >();

2026-03-10 09:05:29 982

原创 Spring Boot 文件上传与下载（图片 _ Excel）

本文承接纯接口开发的基础，完整实战了Spring Boot文件操作的核心场景——本地文件上传、图片上传与回显、Excel上传解析（POI+EasyExcel），覆盖小工具开发的核心需求，核心要点：本地文件上传：核心是生成唯一文件名、创建存储目录、校验文件合法性，通用适配所有文件类型。图片上传：额外增加格式校验、图片压缩，通过静态资源配置实现图片回显，贴合实际开发场景。Excel解析：POI适合复杂场景，EasyExcel适合大数据量，按需选择，核心是将Excel数据映射为实体类，便于后续业务处理。

2026-03-08 16:42:28 717

原创 Spring Boot 接口权限控制：登录 + JWT 实战

核心逻辑：拦截请求 → 从请求头获取令牌 → 验证令牌有效性 → 解析用户信息 → 校验用户权限（可选） → 放行；若令牌无效/无令牌，直接返回401未授权。/*** JWT拦截器：实现接口权限校验// 从配置文件读取请求头中令牌的字段名 @Value("${jwt.header}") private String jwtHeader;/*** 请求预处理（核心方法）：在接口执行前拦截，校验令牌。

2026-03-07 09:01:29 814

原创 Spring Boot 多表关联查询实战（一对多 _ 多对一）

本文以「用户-订单」为实战场景，明确一对多、多对一关系：订单 → 用户。多个订单可以属于同一个用户，订单是“多”的一方，用户是“一”的一方，订单表中需存在外键（user_id）关联用户表的主键（id）。用户 → 订单。一个用户可以拥有多个订单，用户是“一”的一方，订单是“多”的一方，用户表中无需额外添加字段，通过订单表的外键关联。

2026-03-06 11:38:36 571

原创 Spring Boot 项目打包成 JAR 并部署运行（实战完整版）

本文基于前文实战项目（Spring Boot + MyBatis-Plus + 统一返回 + 全局异常 + Swagger），完整实现了「打包配置→打包操作→本地部署→服务器部署」全流程，核心要点总结：打包核心：确保 pom.xml 中 spring-boot-maven-plugin 配置正确（重点是 mainClass），项目无编译报错，配置文件（数据库、端口）适配部署环境；打包方式：IDEA可视化操作适合新手，Maven命令适合无IDEA环境，两种方式均可，打包后优先本地验证JAR包；

2026-02-27 22:41:37 1137

原创 Spring Boot 接口测试：Postman + Swagger 实战（完整版）

本文基于「Spring Boot + MyBatis-Plus」实战项目，完整实现了 Swagger 接口文档自动生成 + Postman 接口调试，核心要点总结：Swagger（Knife4j）：通过依赖导入+简单配置，自动扫描接口，生成规范文档，支持在线调试、文档导出，解决“手动写文档繁琐”“前后端对接分歧”的问题；Postman：通过环境配置、参数传递、批量测试等功能，高效调试接口，覆盖正常/异常场景，确保接口功能符合预期，提升开发和测试效率；

2026-02-25 15:36:10 1516

原创 Spring Boot 统一返回格式 + 全局异常处理（实战版）

先定义一个枚举类，管理所有接口的状态码和对应提示信息，避免硬编码错误码，便于后续维护（可根据项目需求扩展）。/*** 统一返回状态码枚举* 规范：200=成功，4xx=客户端错误，5xx=服务端错误，自定义错误码从1000开始*/// 成功状态SUCCESS(200, "操作成功"),// 客户端错误（4xx）PARAM_ERROR(400, "参数错误"),NOT_FOUND(404, "资源不存在"),METHOD_NOT_ALLOWED(405, "请求方法不允许"),

2026-02-24 17:41:00 1173

原创 Spring Boot + MyBatis-Plus 快速实现单表 CRUD

Spring Boot + MyBatis-Plus 实现单表CRUD的核心，就是“复用MyBatis-Plus内置接口”，无需编写XML和SQL，极大简化了开发流程，核心步骤可总结为3步：准备工作：导入核心依赖、配置数据库连接、创建数据库表；核心编码：编写实体类（关联数据库表）、Mapper接口（继承BaseMapper）、Service层（可选，继承IService）；测试验证：通过测试类或接口，验证新增、查询、修改、删除功能正常。

2026-02-16 13:45:31 1222

原创 Spring Boot + MyBatis-Plus 快速连接 MySQL

Spring Boot + MyBatis-Plus 连接MySQL的核心流程，可总结为4步：搭建Spring Boot项目，导入核心依赖（MyBatis-Plus、MySQL驱动）；编写application.yml，配置数据库连接信息和MyBatis-Plus基础配置；创建实体类和Mapper接口，启动类添加@MapperScan注解；编写测试代码，验证数据库连接和CRUD操作。

2026-02-15 15:00:00 1475

原创 Spring Boot application.yml 最全避坑与多环境配置

问题现象：在yml中自定义配置项（如），通过注入到Java类中，启动报错。根因分析yml中配置项缩进错误，导致自定义配置未被正确解析（如my与spring同级，但缩进不一致）；配置项名称拼写错误（如yml中是，注入时写成my.app.nam使用注入时，未添加@Component或注解，导致配置类未被Spring管理。正确示例# yml配置（缩进正确，与spring同级）spring:profiles:# 自定义配置my:app:// Java类注入（两种方式）

2026-02-14 14:08:58 1063

原创 Spring Boot 项目创建 + 启动排错指南

1. 项目创建核心：重点记住两个关键点——「项目保存路径无中文、无空格」「只勾选Spring Web一个依赖」，依赖下载完成后再启动项目，能避免80%的创建类问题；2. 启动排错逻辑：遇到启动报错，不要慌乱，优先排查3个核心点——「JDK/Maven环境变量是否配置正确」「8080端口是否被占用」「Spring Web依赖是否下载成功」，对照本文的4个高频报错，逐一排查就能快速解决；3. 新手避坑提醒：环境配好、步骤没错，项目启动基本不会报错；不要盲目追求最新版本，稳定版才是新手的最优选择；

2026-02-13 10:06:27 1062

原创 Spring Boot 新手环境搭建超详细指南（避坑版）

其实 Spring Boot 新手环境搭建，并没有想象中那么难，核心就是掌握“3 个工具 + 1 个项目验证”：JDK 是基础，Maven 管依赖，IDEA 提效率，最后通过创建并运行项目，验证环境是否可用。新手只需记住三个核心避坑点：安装/解压路径无中文、无空格；环境变量配置准确；阿里云镜像配置到位，按照本文步骤一步步操作，就能一次性搭建成功，无需反复踩坑。

2026-02-12 11:16:12 1117

码客日记的博客