news 2026/1/9 9:01:15

这些 SpringBoot 默认配置不改,迟早踩坑!

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
这些 SpringBoot 默认配置不改,迟早踩坑!

引言

彼时 SpringBoot 初兴,万象更新,号称“开箱即用”“约定优于配置”,一时间风靡四方。

开发者趋之若鹜,纷纷称快,仿佛自此架构之重可卸、配置之繁可省,一行main()即可气定神闲、纵横沙场。

然则时光久远,方知此言非虚,却也未尽其真。所谓默认,不过是你未曾开口,框架自作主张。表面无碍,实则步步杀机,线上事故十有八九,皆因“未曾配置”的“默认”。

回首往昔,实堪自嘲。曾自诩熟稔底层、精通原理,然于这些藏于阴影处的默认设定,竟茫然不觉。故障一起,仓皇失措,耗时良久,方才发现,不过是框架做了一个并不适合的决定。

是以今日提笔,将过往种种记录于此,只盼后来者少走弯路。

正文

Tomcat连接池

SpringBoot默认使用Tomcat作为Web容器,但默认的连接池配置在高并发场景下会成为瓶颈。

默认配置下,Tomcat的最大连接数只有200,最大线程数也只有200。这意味着当并发请求超过200时,后续请求就会排队等待。在生产环境中,这个配置明显不够用。

server: tomcat: max-connections:10000 # 最大连接数 threads: max:800 # 最大工作线程数 min-spare:100 # 最小空闲线程数 accept-count:100 # 等待队列长度 connection-timeout:20000

更坑的是,SpringBoot的默认超时时间是无限长。这会导致连接一直占用,直到客户端主动断开。

在网络不稳定的环境下,大量连接会一直挂着不释放,最终耗尽服务器资源。

数据库连接池

SpringBoot默认使用HikariCP作为数据库连接池,但默认的连接池配置在生产环境下会成为瓶颈。默认最大连接数只有10个,对于稍微复杂一点的应用来说根本不够用。

spring: datasource: hikari: maximum-pool-size:50 minimum-idle:10 connection-timeout:30000 idle-timeout:600000 max-lifetime:1800000 leak-detection-threshold:60000

特别要注意leak-detection-threshold这个配置。默认情况下这个检测是关闭的,如果代码中存在连接泄漏问题,根本发现不了。

开启后,HikariCP会监控连接的使用时间,超过阈值就会打印警告日志。

JPA懒加载

SpringBoot集成JPA时,默认开启了懒加载。这个设计初衷是好的,但在实际使用中经常会导致N+1查询问题。

@Entity publicclassUser { @Id private Long id; @OneToMany(fetch = FetchType.LAZY) // 默认就是LAZY private List<Order> orders; }

当查询用户列表时,每访问一次orders属性,就会触发一次数据库查询。

如果有100个用户,就会执行101次SQL。

这种情况下,要么使用@EntityGraph指定加载策略,要么在Repository中使用JOIN FETCH

@Query("SELECT u FROM User u LEFT JOIN FETCH u.orders") List<User> findAllWithOrders();

Jackson时区序列化

SpringBoot默认使用Jackson处理JSON序列化,但时区处理经常出问题。

默认情况下,Jackson会使用系统时区,这在分布式部署时会导致不一致的问题。

spring: jackson: time-zone:GMT+8 date-format:yyyy-MM-ddHH:mm:ss serialization: write-dates-as-timestamps:false

更要命的是,如果你的应用部署在不同时区的服务器上,同样的时间可能会被序列化成不同的值。

这个问题在国际化应用中特别突出。

日志配置

SpringBoot默认使用Logback,但默认配置下没有对日志文件进行滚动和清理。

长时间运行的应用会产生巨大的日志文件,最终占满磁盘空间。

logging: file: name:app.log logback: rollingpolicy: max-file-size:100MB max-history:30 total-size-cap:3GB

另外,默认的日志级别是INFO,在生产环境中会产生大量不必要的日志。

合理设置日志级别可以显著提升性能。

缓存配置

SpringBoot的@Cacheable注解默认使用ConcurrentHashMap作为缓存实现,但这个实现没有过期机制,也没有大小限制。在高并发场景下,缓存会无限增长,最终导致内存溢出。

spring: cache: type:caffeine caffeine: spec:maximumSize=10000,expireAfterWrite=600s

可以考虑使用Caffeine替代默认实现,可以提供更好的性能和内存管理能力。

监控端点

SpringBoot Actuator默认暴露了很多监控端点,包括健康检查、配置信息、环境变量等。

这些信息在开发环境中很有用,但在生产环境中可能泄漏敏感信息。

management: endpoints: web: exposure: include:health,info,metrics endpoint: health: show-details:when-authorized

只暴露必要的端点,并且配置适当的安全策略,避免信息泄漏。

文件上传大小限制

SpringBoot默认的文件上传限制非常小,单个文件只能上传1MB,整个请求大小限制10MB。

在实际业务中,这个限制经常不够用,用户上传稍大一点的文件就会报错。

这个属于是比较常见的问题,因为开发环境测试时通常用小文件,一切正常。等到用户上传几MB的PDF文档或者高清图片时,系统就开始报MaxUploadSizeExceededException异常。

这个异常往往还发生在文件传输完成之后,用户等了半天上传完毕,结果被告知文件过大,体验极差。

spring: servlet: multipart: max-file-size:100MB max-request-size:100MB file-size-threshold:2KB location:/tmp resolve-lazily:false

file-size-threshold这个参数也很重要,它决定了多大的文件会直接写入内存。如果设置过大,大量并发上传会占用过多内存;设置过小,小文件也要写磁盘,影响性能。一般设置为几KB比较合适。

异步线程池配置

使用@Async注解时,SpringBoot默认使用SimpleAsyncTaskExecutor,这个执行器每次都会创建新线程,没有线程池复用机制。高并发情况下会创建大量线程,最终导致系统资源耗尽。

这个问题在开发阶段很难发现,因为异步任务通常不多。但在生产环境,如果有大量异步任务执行,比如发送短信、推送、记录日志等,系统会不断创建新线程。每个线程默认占用1MB的栈空间,创建几千个线程就是几GB内存。

更严重的是线程切换的开销,CPU大部分时间都在做上下文切换,真正的业务逻辑反而执行很慢。

spring: task: execution: pool: core-size:8 max-size:16 queue-capacity:100 keep-alive:60s thread-name-prefix:async-task- scheduling: pool: size:4 thread-name-prefix:scheduling-

线程池大小的设置也有讲究。

如果是CPU密集型任务,线程数设置为CPU核心数就够了;如果是IO密集型任务,可以设置为CPU核心数的2-3倍。

queue-capacity设置了任务队列长度,当线程池满了之后,新任务会放到队列里等待执行。

静态资源缓存策略

SpringBoot默认不为静态资源设置HTTP缓存头,这意味着浏览器每次都会重新请求CSS、JS、图片等静态文件,严重影响页面加载性能。

用户每次访问页面,浏览器都要重新下载所有静态资源,即使这些文件根本没有变化。对于资源较多的单页应用来说,这个问题特别明显。用户看到的就是页面加载慢,特别是网络条件不好的时候,体验很差。

spring: web: resources: cache: cachecontrol: max-age:365d cache-public:true chain: strategy: content: enabled:true paths:/** cache:true static-locations:classpath:/static/

开启内容版本化策略后,SpringBoot会根据文件内容生成MD5哈希值作为版本号,文件名变成style-abc123.css这样的格式。当文件内容发生变化时,哈希值也会变化,浏览器会认为这是新文件重新下载;如果文件没变化,浏览器就直接使用缓存,有效提升页面加载速度。

数据库事务超时

@Transactional注解默认没有设置超时时间,长时间运行的事务会一直持有数据库锁,影响其他操作的执行。特别是在批量数据处理时,很容易出现锁表问题。

这个问题在并发量不高的时候不明显,但随着业务增长,长事务的危害就暴露出来了。

比如一个数据导入任务需要处理几万条记录,如果放在一个事务里,可能要运行几分钟甚至更长时间。在这期间,相关的表都被锁住,其他用户的操作只能等待,系统响应变得很慢。

@Transactional(timeout = 30, rollbackFor = Exception.class) publicvoidbatchProcess(List<Data> dataList) { // 分批处理,避免长事务 intbatchSize=100; for (inti=0; i < dataList.size(); i += batchSize) { List<Data> batch = dataList.subList(i, Math.min(i + batchSize, dataList.size())); processBatch(batch); } }

对于大批量数据处理,建议分成多个小事务,每个事务处理少量数据。这样即使某个小事务失败,也不会影响整体进度,而且可以及时释放数据库锁,提高系统并发性能。

同时再加上rollbackFor = Exception.class确保所有异常都会触发回滚,避免数据不一致。

写在最后

Spring Boot 的“约定优于配置”确实省心,但省的是开发者的心,不是系统的责任。每一项默认配置背后,其实都藏着设计者的假设和权衡,而这些假设,在我们的业务场景中也许未必成立。

这些坑我几乎都踩过,有些甚至反复踩了好几次。

愿你读到这里,能少走几步弯路,可不能拿生产事故去交学费。

提前优化配置,是对系统负责,也是对自己负责。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/1/5 4:43:32

收藏速看!LangGraph1.0入门宝典—— 核心概念与“点边”实战

对于刚入门大模型开发的程序员来说&#xff0c;LangGraph 绝对是值得深耕的框架——它不是简单的工具封装&#xff0c;而是一套能让你“编程式构建智能体”的强大体系。这篇文章作为 LangGraph1.0 系列的开篇&#xff0c;会用最直观的方式拆解核心概念&#xff0c;再通过完整代…

作者头像 李华
网站建设 2025/12/30 18:05:58

小程序毕设项目推荐-基于springboot的“智宠”一站式宠物服务小程序的设计与实现宠物信息管理、服务预约、订单管理、商品管理【附源码+文档,调试定制服务】

博主介绍&#xff1a;✌️码农一枚 &#xff0c;专注于大学生项目实战开发、讲解和毕业&#x1f6a2;文撰写修改等。全栈领域优质创作者&#xff0c;博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围&#xff1a;&am…

作者头像 李华
网站建设 2025/12/19 0:06:28

RabbitMQ 5 大核心模式详解(一):简单模式 工作队列模式

RabbitMQ 作为一款高性能的开源消息队列&#xff0c;基于 AMQP&#xff08;高级消息队列协议&#xff09;实现&#xff0c;凭借其轻量级、高可用、易扩展的特性&#xff0c;被广泛应用于分布式系统的解耦、异步通信、流量削峰等场景。RabbitMQ 的核心能力体现在多种消息投递模式…

作者头像 李华
网站建设 2025/12/19 0:05:45

如何设定环境Agent的监测频率才能兼顾实时性与资源消耗?

第一章&#xff1a;环境Agent监测频率的核心挑战在现代分布式系统中&#xff0c;环境Agent承担着采集节点状态、资源利用率和运行时指标的关键职责。监测频率的设定直接影响系统性能与数据实时性之间的平衡。过高频率会加剧网络负载并消耗大量计算资源&#xff0c;而过低则可能…

作者头像 李华
网站建设 2025/12/30 17:20:41

练题100天——DAY30:下一个更大的元素+键盘行

今天写了四道题&#xff01;尽管前两道很简单&#xff08;所以没放到标题里面&#xff09;。难度范围&#xff1a;★~★★★&#xff0c;昨天最后一道困难题是打击到我了&#xff0c;但没关系&#xff0c;我自己会从简单题中找安慰&#xff08;倒&#xff09;。 今天的主要收获…

作者头像 李华