spring-boot-starter-components
约 572 字大约 2 分钟
2026-05-09
通用能力聚合：為業務模塊提供系統管理、交易支付、內容、文件、消息、核驗、任務調度等可裝配 starter；多數能力採用 -api（契約/DTO/配置）+ -biz（實現、HTTP、自動配置）分層。
spring-boot-starter-common（統一響應、異常、基礎實體、MQ 基礎設施等）已作為 starter-module 的直接子模塊，見其 common。
子模塊一覽（與 pom.xml 一致）
| 模塊 | 業務與職責摘要 | 文檔 |
|---|---|---|
spring-boot-starter-system | 登錄/驗證碼、用户組織角色權限等後台與用户端能力 | system |
spring-boot-starter-trade | 商品訂單、微信支付；支付成功後 MQ 發佈 trade.order-goods.paid | trade |
spring-boot-starter-distribution | 分銷分傭、錢包；MQ 消費支付事件、request-reply 查詢推廣角色 | distribution |
spring-boot-starter-verification | 二要素核驗、資產認證；核驗通過後 MQ 通知 customer 等 | verification |
spring-boot-starter-wechat | 微信網頁能力、登錄等（WxController / WxLoginController） | |
spring-boot-starter-file | 上傳與文件管理（FileController、MgtFileController 等） | file |
spring-boot-starter-cms | CMS 節點；公開與管理端接口 | cms |
spring-boot-starter-im | IM 相關用户端接口 | im |
spring-boot-starter-excel | Excel 導入導出（如 PubExcelController） | excel |
spring-boot-starter-ocr | OCR HTTP（銀行卡等），底層實現通過命名 Bean（如 bizKsOcrService） | ocr |
spring-boot-starter-sms | 短信發送門面，多廠商 SPI 實現可切換 | sms |
v3.6.0 起已移除：
spring-boot-starter-dict（通用字典）、spring-boot-starter-generator（代碼生成）、spring-boot-starter-job（XXL-Job 集成説明模塊）。詳見 TG-boot 總覽 · 版本變更。
裝配方式
- 各
-biz模塊通過META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports註冊Biz*AutoConfiguration，引入對應依賴後即參與 Spring Boot 自動配置。 - 跨模塊協作優先依賴 對方
-api模塊 中的接口與 DTO，避免直連-biz實現類。
擴展建議
- 新增組件：在本聚合下新建
spring-boot-starter-xxx（含-api/-biz），並實現自動配置類。 - 跨模塊事件：在
-api/messaging定義XxxConsumer契約與消息 DTO，在-biz/messaging實現發佈/消費；binding 由 common 自動註冊。
源碼路徑：tg-boot/spring-boot-starter-module/spring-boot-starter-components/