引言

彼時 SpringBoot 初興，萬象更新，號稱“開箱即用”“約定優(yōu)于配置”，一時間風(fēng)靡四方。

開發(fā)者趨之若鶩，紛紛稱快，仿佛自此架構(gòu)之重可卸、配置之繁可省，一行 main() 即可氣定神閑、縱橫沙場。

然則時光久遠(yuǎn)，方知此言非虛，卻也未盡其真。所謂默認(rèn)，不過是你未曾開口，框架自作主張。表面無礙，實則步步殺機(jī)，線上事故十有八九，皆因“未曾配置”的“默認(rèn)”。

回首往昔，實堪自嘲。曾自詡熟稔底層、精通原理，然于這些藏于陰影處的默認(rèn)設(shè)定，竟茫然不覺。故障一起，倉皇失措，耗時良久，方才發(fā)現(xiàn)，不過是框架做了一個并不適合的決定。

是以今日提筆，將過往種種記錄于此，只盼后來者少走彎路。

正文

Tomcat連接池

SpringBoot默認(rèn)使用Tomcat作為Web容器，但默認(rèn)的連接池配置在高并發(fā)場景下會成為瓶頸。

默認(rèn)配置下，Tomcat的最大連接數(shù)只有200，最大線程數(shù)也只有200。這意味著當(dāng)并發(fā)請求超過200時，后續(xù)請求就會排隊等待。在生產(chǎn)環(huán)境中，這個配置明顯不夠用。

server:
  tomcat:
    max-connections: 10000  # 最大連接數(shù)
    threads:
      max: 800              # 最大工作線程數(shù)
      min-spare: 100        # 最小空閑線程數(shù)
    accept-count: 100       # 等待隊列長度
    connection-timeout: 20000

更坑的是，SpringBoot的默認(rèn)超時時間是無限長。這會導(dǎo)致連接一直占用，直到客戶端主動斷開。

在網(wǎng)絡(luò)不穩(wěn)定的環(huán)境下，大量連接會一直掛著不釋放，最終耗盡服務(wù)器資源。

數(shù)據(jù)庫連接池

SpringBoot默認(rèn)使用HikariCP作為數(shù)據(jù)庫連接池，但默認(rèn)的連接池配置在生產(chǎn)環(huán)境下會成為瓶頸。默認(rèn)最大連接數(shù)只有10個，對于稍微復(fù)雜一點的應(yīng)用來說根本不夠用。

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這個配置。默認(rèn)情況下這個檢測是關(guān)閉的，如果代碼中存在連接泄漏問題，根本發(fā)現(xiàn)不了。

開啟后，HikariCP會監(jiān)控連接的使用時間，超過閾值就會打印警告日志。

JPA懶加載

SpringBoot集成JPA時，默認(rèn)開啟了懶加載。這個設(shè)計初衷是好的，但在實際使用中經(jīng)常會導(dǎo)致N+1查詢問題。

@Entity
public class User {
    @Id
    private Long id;
    
    @OneToMany(fetch = FetchType.LAZY)  // 默認(rèn)就是LAZY
    private List<Order> orders;
}

當(dāng)查詢用戶列表時，每訪問一次orders屬性，就會觸發(fā)一次數(shù)據(jù)庫查詢。

如果有100個用戶，就會執(zhí)行101次SQL。

這種情況下，要么使用@EntityGraph指定加載策略，要么在Repository中使用JOIN FETCH。

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

Jackson時區(qū)序列化

SpringBoot默認(rèn)使用Jackson處理JSON序列化，但時區(qū)處理經(jīng)常出問題。

默認(rèn)情況下，Jackson會使用系統(tǒng)時區(qū)，這在分布式部署時會導(dǎo)致不一致的問題。

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

更要命的是，如果你的應(yīng)用部署在不同時區(qū)的服務(wù)器上，同樣的時間可能會被序列化成不同的值。

這個問題在國際化應(yīng)用中特別突出。

日志配置

SpringBoot默認(rèn)使用Logback，但默認(rèn)配置下沒有對日志文件進(jìn)行滾動和清理。

長時間運行的應(yīng)用會產(chǎn)生巨大的日志文件，最終占滿磁盤空間。

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

另外，默認(rèn)的日志級別是INFO，在生產(chǎn)環(huán)境中會產(chǎn)生大量不必要的日志。

合理設(shè)置日志級別可以顯著提升性能。

緩存配置

SpringBoot的@Cacheable注解默認(rèn)使用ConcurrentHashMap作為緩存實現(xiàn)，但這個實現(xiàn)沒有過期機(jī)制，也沒有大小限制。在高并發(fā)場景下，緩存會無限增長，最終導(dǎo)致內(nèi)存溢出。

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

可以考慮使用Caffeine替代默認(rèn)實現(xiàn)，可以提供更好的性能和內(nèi)存管理能力。

監(jiān)控端點

SpringBoot Actuator默認(rèn)暴露了很多監(jiān)控端點，包括健康檢查、配置信息、環(huán)境變量等。

這些信息在開發(fā)環(huán)境中很有用，但在生產(chǎn)環(huán)境中可能泄漏敏感信息。

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

只暴露必要的端點，并且配置適當(dāng)?shù)陌踩呗?，避免信息泄漏?/p>

文件上傳大小限制

SpringBoot默認(rèn)的文件上傳限制非常小，單個文件只能上傳1MB，整個請求大小限制10MB。

在實際業(yè)務(wù)中，這個限制經(jīng)常不夠用，用戶上傳稍大一點的文件就會報錯。

這個屬于是比較常見的問題，因為開發(fā)環(huán)境測試時通常用小文件，一切正常。等到用戶上傳幾MB的PDF文檔或者高清圖片時，系統(tǒng)就開始報 MaxUploadSizeExceededException 異常。

這個異常往往還發(fā)生在文件傳輸完成之后，用戶等了半天上傳完畢，結(jié)果被告知文件過大，體驗極差。

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

file-size-threshold 這個參數(shù)也很重要，它決定了多大的文件會直接寫入內(nèi)存。如果設(shè)置過大，大量并發(fā)上傳會占用過多內(nèi)存；設(shè)置過小，小文件也要寫磁盤，影響性能。一般設(shè)置為幾KB比較合適。

異步線程池配置

使用@Async注解時，SpringBoot默認(rèn)使用SimpleAsyncTaskExecutor，這個執(zhí)行器每次都會創(chuàng)建新線程，沒有線程池復(fù)用機(jī)制。高并發(fā)情況下會創(chuàng)建大量線程，最終導(dǎo)致系統(tǒng)資源耗盡。

這個問題在開發(fā)階段很難發(fā)現(xiàn)，因為異步任務(wù)通常不多。但在生產(chǎn)環(huán)境，如果有大量異步任務(wù)執(zhí)行，比如發(fā)送短信、推送、記錄日志等，系統(tǒng)會不斷創(chuàng)建新線程。每個線程默認(rèn)占用1MB的棧空間，創(chuàng)建幾千個線程就是幾GB內(nèi)存。

更嚴(yán)重的是線程切換的開銷，CPU大部分時間都在做上下文切換，真正的業(yè)務(wù)邏輯反而執(zhí)行很慢。

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-

線程池大小的設(shè)置也有講究。

如果是CPU密集型任務(wù)，線程數(shù)設(shè)置為CPU核心數(shù)就夠了；如果是IO密集型任務(wù)，可以設(shè)置為CPU核心數(shù)的2-3倍。

queue-capacity設(shè)置了任務(wù)隊列長度，當(dāng)線程池滿了之后，新任務(wù)會放到隊列里等待執(zhí)行。

靜態(tài)資源緩存策略

SpringBoot默認(rèn)不為靜態(tài)資源設(shè)置HTTP緩存頭，這意味著瀏覽器每次都會重新請求CSS、JS、圖片等靜態(tài)文件，嚴(yán)重影響頁面加載性能。

用戶每次訪問頁面，瀏覽器都要重新下載所有靜態(tài)資源，即使這些文件根本沒有變化。對于資源較多的單頁應(yīng)用來說，這個問題特別明顯。用戶看到的就是頁面加載慢，特別是網(wǎng)絡(luò)條件不好的時候，體驗很差。

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

開啟內(nèi)容版本化策略后，SpringBoot會根據(jù)文件內(nèi)容生成MD5哈希值作為版本號，文件名變成style-abc123.css這樣的格式。當(dāng)文件內(nèi)容發(fā)生變化時，哈希值也會變化，瀏覽器會認(rèn)為這是新文件重新下載；如果文件沒變化，瀏覽器就直接使用緩存，有效提升頁面加載速度。

數(shù)據(jù)庫事務(wù)超時

@Transactional注解默認(rèn)沒有設(shè)置超時時間，長時間運行的事務(wù)會一直持有數(shù)據(jù)庫鎖，影響其他操作的執(zhí)行。特別是在批量數(shù)據(jù)處理時，很容易出現(xiàn)鎖表問題。

這個問題在并發(fā)量不高的時候不明顯，但隨著業(yè)務(wù)增長，長事務(wù)的危害就暴露出來了。

比如一個數(shù)據(jù)導(dǎo)入任務(wù)需要處理幾萬條記錄，如果放在一個事務(wù)里，可能要運行幾分鐘甚至更長時間。在這期間，相關(guān)的表都被鎖住，其他用戶的操作只能等待，系統(tǒng)響應(yīng)變得很慢。

@Transactional(timeout = 30, rollbackFor = Exception.class)
public void batchProcess(List<Data> dataList) {
    // 分批處理，避免長事務(wù)
    int batchSize = 100;
    for (int i = 0; i < dataList.size(); i += batchSize) {
        List<Data> batch = dataList.subList(i, 
            Math.min(i + batchSize, dataList.size()));
        processBatch(batch);
    }
}

對于大批量數(shù)據(jù)處理，建議分成多個小事務(wù)，每個事務(wù)處理少量數(shù)據(jù)。這樣即使某個小事務(wù)失敗，也不會影響整體進(jìn)度，而且可以及時釋放數(shù)據(jù)庫鎖，提高系統(tǒng)并發(fā)性能。

同時再加上rollbackFor = Exception.class確保所有異常都會觸發(fā)回滾，避免數(shù)據(jù)不一致。

寫在最后

Spring Boot 的“約定優(yōu)于配置”確實省心，但省的是開發(fā)者的心，不是系統(tǒng)的責(zé)任。每一項默認(rèn)配置背后，其實都藏著設(shè)計者的假設(shè)和權(quán)衡，而這些假設(shè)，在我們的業(yè)務(wù)場景中也許未必成立。

這些坑我?guī)缀醵疾冗^，有些甚至反復(fù)踩了好幾次。

愿你讀到這里，能少走幾步彎路，可不能拿生產(chǎn)事故去交學(xué)費。

提前優(yōu)化配置，是對系統(tǒng)負(fù)責(zé)，也是對自己負(fù)責(zé)。

到此這篇關(guān)于SpringBoot默認(rèn)配置的具體使用(遲早踩坑)的文章就介紹到這了,更多相關(guān)SpringBoot默認(rèn)配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論