子冉冰清的博客

类含义Date旧版时间对象LocalDate只有日期日期 + 时间 + 时区LocalDate = 生日ZonedDateTime = 国际航班时间Date = 历史遗留对象在现代 Java 开发中，推荐优先使用java.time包中的 API，它更加安全、清晰且功能强大。

摘要：本文分析了Spring Boot应用中SSE(Server-Sent Events)推送数据时出现的"No suitable converter"异常问题。问题根源在于SseEmitter.event()方法使用不当导致消息转换器无法识别数据类型。提供了两种解决方案：1)显式指定MediaType.APPLICATION_JSON参数；2)直接使用emitter.send()简化调用方式。文章详细说明了修改位置，包括AI对话流式响应和任务进度推送功能，并展示了修复后的正确数据流格式。通过重启服务验证，

SQL 复杂（多表 join / 子查询 / 聚合）📌 切换到 JPA 的收益不明显，但风险很大。下面我们从多个维度拆解这个选择背后的原因。👉 SQL 怎么写，数据库就怎么跑。这并不是“JPA 不好”，而是。DBA 会 review SQL。📌 JPA：绕路 or 放弃。数据量大（千万 / 亿级）一条方法 = 一条 SQL。MySQL 索引 Hint。📌 MyBatis：直接写。SQL 是否合理，一眼可见。性能要求极高（毫秒级）是否有索引，一看就知道。报表、推荐、统计频繁。

将 Spring MVC 的路径匹配策略改回 ant_path_matcher，使其与 Swagger 兼容。- Swagger UI 可访问：http://localhost:8080/swagger-ui/如果您不需要 Swagger 文档功能，也可以选择删除 Swagger 相关依赖和配置类。- 所有 RESTful 接口正常工作。🚀 现在可以重新启动应用。

接口耗时属于横切关注点，应统一在 Spring MVC 拦截器中处理，避免侵入 Controller 业务逻辑。

概念含义TraceId一次请求的唯一标识Span调用链中的一个节点MDC日志上下文存储TraceId 就足够MDC（Mapped Diagnostic Context）是 Logback 提供的线程级上下文变量存储。日志中即可自动打印。✅ Filter 生成 TraceId✅ MDC 保存上下文✅ 日志格式统一✅ 接口日志 + 异常日志✅ 日志分级清晰统一日志与链路追踪，是后端系统“可运维性”的基石。在 Spring Boot 项目中：MDC 是最低成本的链路追踪方案。

统一返回结构是接口规范的基础全局异常处理是系统健壮性的保障Controller 应该只处理业务逻辑异常交给全局处理，返回交给统一模型这是成熟后端项目的必备能力。

Spring Boot 提供了极其完善的 RESTful 开发支持，使得：接口定义简洁清晰JSON 处理高度自动化易于前后端分离适合微服务架构掌握 RESTful 风格，不仅是学会几个注解，更重要的是理解资源导向和统一接口设计思想。

RESTful✅。

一个，包含：系统架构Nginx 配置Java 代码（短链生成 + 统计 + 302 跳转）Redis 数据结构访问统计方案这是一个完整、可部署的模板。

对比维度Spring（传统方式）依赖管理手动指定每个依赖和版本，容易冲突Starter 自动引入常用依赖，BOM 管理版本配置文件需要web.xml几乎零配置，只需容器部署打包 war，部署到外部 Tomcat/Jetty内嵌 Tomcat，直接java -jar运行REST 返回 JSON需要引入 Jackson，并配置默认支持 JSON，自动注册 MessageConverter环境配置配置分散在 XML / properties统一在，支持多 profile生产级功能。

Starter 可以理解为一组模块化依赖，它们帮助我们快速集成某种功能。会自动引入：Spring MVCTomcat 依赖让我们可以直接写提供接口。官方提供了大量 Starter（如），社区也有第三方 Starter，甚至可以编写自定义 Starter。假设我们要封装一个Spring Boot Starter 本质上是依赖管理 + 自动配置的组合，它极大降低了上手门槛。通过SPI + 条件注解，实现了灵活可控的 Bean 装配。

下面写一个，用搭建一个问答系统。下面我会给出完整架构、核心代码示例，以及如何运行。

格式化、解析日期（基于java.timeJsonUtil（通常封装 Jackson）→ String→ 对象统一返回结果Result.fail("错误")MD5、SHA256、AES、RSA 等加解密IdUtil生成 UUID、雪花算法 ID✅ 总结：SpringBoot 项目里最常用的工具类主要是Spring 自带的AssertBeanUtils等；然后结合来增强；最后根据业务写一些时间/JSON/加解密工具类。整理一个SpringBoot 常用工具类速查表（CheatSheet），里面包含。

使用分别指定不同包下的 Mapper，绑定到不同的数据源。

Spring Security 虽然一开始上手有些复杂，但它的过滤器链机制认证授权模型和可扩展性非常强大。小项目可直接用表单登录 + Session前后端分离项目推荐使用JWT企业级项目可以扩展OAuth2 / SSO / 自定义认证Spring Security，不仅要会用，更要理解它的认证与授权核心流程，这样才能在复杂业务场景下灵活扩展。

Spring 通过三级缓存（singletonObjects / earlySingletonObjects / singletonFactories）和，解决了大部分单例 + Setter/Field 注入的循环依赖。构造器循环依赖、prototype Bean无法解决。Spring Boot 2.6+ 默认关闭循环依赖，需要显式开启。从设计角度，循环依赖往往是架构问题，最佳做法是重构消除循环。

这段过滤器的功能：从请求头中提取 JWT。校验并解析 Token，获取username和userId。将认证信息注入到 Spring Security 上下文（将userId和username存入request，方便后续使用。如果 Token 失效或异常，不会中断请求，而是继续执行（只是不注入认证信息）。

而且还会提示 仅在开发模式下用，安全配置密码在生产环境必须更新。里，默认情况下并没有固定的账号密码，只有当你在项目中。这个密码只在程序运行期间有效，每次重启都会生成新的。在访问的时候会有个这样的账号密码认证来拦截访问。这里输入的就是上面的账号密码了。如果你想自定义账号，可以在。

方案长度顺序性依赖组件性能 (QPS)复杂度适用场景数据库自增 ID短有序数据库低低小型项目长无序无高低日志追踪Redis INCR短有序Redis高中电商订单Snowflake中趋势有序无高中高并发系统Zookeeper 顺序 ID短有序ZK中高金融业务百度 UidGenerator中有序DB极高中高并发场景美团 Leaf中有序DB/ZK极高高分布式系统小型项目：用数据库自增即可。日志、追踪。

通过以上步骤，我们成功搭建了一个Spring Boot 多模块项目父工程统一管理依赖版本，保证一致性；子模块按功能拆分，职责清晰；web-api模块作为入口，组合其他模块的能力；后续可以方便地扩展更多模块，如等。这种结构特别适合中大型项目，能够有效提升团队协作效率和代码可维护性。

springfox在 Spring Boot 2.6 开始就有很多兼容性 bug（主要是 Spring MVC PathPatternParser 的引入），导致在 Spring Boot 2.6/2.7 里经常出现的情况。

写一个，可以直接跑起来验证。

在 Spring Boot 中配置多个环境（开发、测试、生产）通常用 配置文件分环境管理 + 启动参数切换 的方式来实现。下面一个完整的实践指南：Spring Boot 默认支持 或 文件。常见方式是创建以下配置文件：示例：application.yml（通用配置）application-dev.yml（开发环境）application-prod.yml（生产环境）🔹 2. 启动时指定环境方法 1：在 设置方法 2：命令行参数（推荐，灵活）方法 3：环境变量🔹 3.

** 锁名（前缀） *//** 业务 key 的 SpEL，例如 "#skuId" 或 "#req.userId + ':' + #req.orderId" *//** 过期毫秒 *//** 最长等待毫秒 *//** 是否自动续期 *//** 获取失败是否抛异常；false 则直接跳过执行业务 */

本文介绍了Spring Boot 集成 Redis 的完整流程，从环境搭建、依赖引入、基础操作，到与 Spring Cache 注解的整合，并补充了 Redis 在实际业务中的应用场景与常见问题。合理利用 Redis，不仅能显著提升系统性能，还能在高并发场景下保障服务稳定性。

操作系统：iOS 16.0设备类型浏览器：Safari⚠️注意事项部分新版本浏览器已逐步弃用 UA，转向；UA 可伪造，统计结果仅供参考。@Component@Override= null) {// 操作系统// 设备// 浏览器log.info("设备来源统计: OS={}, Device={}, Browser={}", os, device, browser);// TODO: 写入 Redis / DB 做统计核心点：通过拦截器获取User-Agent，使用。

请求 URL请求参数执行耗时返回结果@Aspect@Component@Slf4j// 切入点：拦截所有 controller 包下的方法/*** 环绕通知：执行前后都能做操作*/// 获取请求相关信息log.info("====== 请求开始 ======");log.info("HTTP方法 : {}", request.getMethod());

首先定义一个通用的响应对象这样一来，无论成功还是失败，都能保证返回结果的结构一致。除了系统异常（等），我们还需要定义业务异常例如：用户不存在、余额不足、参数非法等，都可以通过来抛出。通过全局异常处理统一返回结构，方便前端解析。集中管理异常，减少冗余try-catch。区分业务异常与系统异常，提升代码可维护性。可扩展性强，后续可以接入日志系统（如 Logback、ELK）或异常监控平台（如 Sentry）。建议在实际项目中，将全局异常处理。

定义通用方法（接口）。业务接口，扩展。默认实现，帮你实现了IService的所有方法。实现类，继承，可以直接用 CRUD，也可以扩展业务方法。所以：👉写的代码只需要关心业务逻辑，CRUD 全交给 MyBatis-Plus 的基类完成。

如果 SQL 比较简单，基本不需要写 Mapper XML。如果涉及复杂查询，可以MP + 自定义 XML混合使用。常见增强：分页、条件构造器、批量操作、乐观锁、多租户插件。这样，就能快速从MyBatis 手写 SQL升级到MyBatis-Plus 高效开发🚀。

Data;@Mapper✅ 这里用注解方式，简单清晰；复杂 SQL 可以写到 XML 文件。

实现一个的完整版本，这样能实时统计各接口的访问平台（Android / iOS / Mac / Windows / H5），并且每天定时把 Redis 里的数据写到 MySQL 做历史报表。

JPA（Java Persistence API）并不是一个具体实现，而是Java 官方定义的 ORM 规范Hibernate（最常用，Spring Boot 默认 JPA 实现）OpenJPA核心思想用实体类（Entity）映射数据库表，用方法调用代替手写 SQL。// 查询所有用户// 根据用户名查询几乎零配置即可运行面向对象操作数据库，减少 SQL 编写内置方法丰富，支持分页、排序、条件查询复杂 SQL 也可以灵活编写。

提示中没有主清单属性报错解决方案这个错通常出现在你用 启动，但 JAR 的 里没有 条目（或没按可执行 JAR 的方式打包）。快速检查 + 常见解决方案如下：如果你用 Maven 或 Gradle，推荐在构建阶段就写好 并（如果需要）生成 fat/uber-jar。Maven ()：生成包含依赖的可执行 jar 用 或 （Spring Boot 项目）。Gradle（普通 jar）：如果要包含依赖（fat jar），用 插件或 插件的打包方式。修复完以后，再次运行就可以看到正常的启动信息输

想要的效果其实就是，然后在里通过占位符读取，而不写明文。这样即便被提交到 Git，也不会泄露 key。

都是datetime类型，但是一开始都是保留了6位小数，导致毫秒都显示出来了。但是如果这里只想要保留时分秒，不需要精确到毫秒级别的话，就可以格式化处理一下。将其放到resources/db.migration路径下。然后更新表格字段的存储格式,执行一个脚本SQL。最后就能得到这种时间戳格式的显示了。假设有这样一个SQL表，其中。然后添加Flyway库。

适用于更底层的控制（不推荐，除非有特殊需求）。@Component@Override.allowedOrigins("http://localhost:3000") // 推荐明确指定前端地址.allowedHeaders("*") // 可选，允许前端发送的自定义 Header// 可选，预检请求的缓存时间（单位秒）

遇到这样的一个场景，代码部署到私有服务器上去之后，这台私有服务器a无法直接访问公网，需要通过代理转发到另外一台专门访问公网的服务器b, 让服务器b去请求对应的公网ip，于是就需要设置Http代理。通常使用springboot会用到两种不同的httpclientspring-boot-starter-webflux 这个包下面的WebClientSpring-web 这个包下面的RestTemplate。

appender=com.p6spy.engine.spy.appender.StdoutLogger # 或者使用 Log4jAppender。driver-class-name: com.p6spy.engine.spy.P6SpyDriver # 使用 P6Spy 驱动。启动应用程序后，执行数据库查询时，你将在控制台上看到 SQL 查询和执行时间的输出。driver=com.mysql.cj.jdbc.Driver # 使用你的数据库驱动。这个优点是可以看到具体的执行结果集合。