1. 為什么這個系列的第一篇要寫CRUD微服務落地的第一塊敲門磚先說一個很多人容易誤解的點Spring Cloud 是個宏觀的微服務治理方案名字里帶個云字但實際上它解決的不是業(yè)務代碼怎么寫而是多個服務進程之間怎么組織、怎么發(fā)現(xiàn)、怎么通信、怎么容錯。CRUD 則是任何業(yè)務系統(tǒng)里最基礎、也最繞不開的數(shù)據(jù)操作能力。把 Spring Cloud 和 CRUD 放到一起整合本質(zhì)上是做這樣一件事讓一個業(yè)務模塊以微服務的方式跑起來并且通過注冊中心、網(wǎng)關、服務調(diào)用這些 Spring Cloud 核心組件完成完整的請求鏈路。我自己的體會是網(wǎng)上一搜 Spring Cloud鋪天蓋地都是注冊中心原理網(wǎng)關過濾器分布式事務這些偏治理側(cè)的內(nèi)容反而很少有人把一個最簡單的用戶模塊從數(shù)據(jù)庫到前端接口完整走通微服務調(diào)用鏈這件事講清楚。但實際項目落地的時候你第一步需要的就是一個能跑通的 CRUD 服務因為它的鏈路最短、問題最直觀、也最適合用來驗證整套基礎設施是否正常。這篇文章定位為Spring Cloud 整合一適合兩類人一類是剛接觸微服務、想搭一套本地可運行 Demo 的開發(fā)者另一類是已經(jīng)用單體寫過很多 CRUD、想看看同一套業(yè)務代碼放到微服務架構(gòu)里會發(fā)生什么變化的同學。文章里我會把選型理由、配置細節(jié)、啟動順序、踩坑記錄一次講透保證你照著做能跑起來而不是看了一堆抽象概念。整體架構(gòu)我會控制在三個服務內(nèi)一個用于演示 CRUD 的user-service一個負責轉(zhuǎn)發(fā)請求的網(wǎng)關服務gateway-service再加上注冊中心 Nacos。后文還會引入 OpenFeign 演示服務間調(diào)用這也是微服務場景下最典型的用法。2. 版本選型與父工程搭建這一步?jīng)Q定后面三個月是否順利2.1 Spring Cloud 與 Spring Boot 的版本對應關系Spring Cloud 的版本號經(jīng)歷了一次重要變化。早期用Dalston、Edgware、Hoxton這類倫敦地鐵站名來命名從2020.0開始改成了年份命名方式。很多新手在這里第一個坑就是Spring Cloud 和 Spring Boot 必須嚴格匹配否則啟動時會報各種莫名其妙的 NoClassDefFoundError 或者 Bean 創(chuàng)建異常。我這里直接給出兩套經(jīng)過驗證的穩(wěn)定組合你可以按自己的 JDK 情況選組合JDKSpring BootSpring CloudSpring Cloud Alibaba傳統(tǒng)穩(wěn)定組合8/112.7.182021.0.82021.0.5.0新版組合173.2.x2023.0.x2023.0.1.0我個人建議如果是為了學習和本地驗證優(yōu)先選第一套JDK 8 Spring Boot 2.7.18 Spring Cloud 2021.0.8。原因很現(xiàn)實這套組合的網(wǎng)上資料最多遇到問題一搜就有答案而且 Nacos、Gateway、OpenFeign 這些組件的兼容性都已經(jīng)被大量生產(chǎn)項目驗證過了。Spring Boot 3.x 雖然新但 Jakarta EE 的包名遷移、Spring Security 6 的配置變化對初學者來說排查成本偏高。2.2 父 POM 的依賴管理我會創(chuàng)建一個 Maven 父工程只放依賴管理和公共屬性不寫業(yè)務代碼。這樣做的好處是子模塊之間版本統(tǒng)一后續(xù)引入新的微服務模塊時不需要再重復指定版本號。父 POM 的核心內(nèi)容如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent properties spring-cloud.version2021.0.8/spring-cloud.version spring-cloud-alibaba.version2021.0.5.0/spring-cloud-alibaba.version mybatis-plus.version3.5.3.2/mybatis-plus.version /properties dependencyManagement dependencies dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-dependencies/artifactId version${spring-cloud.version}/version typepom/type scopeimport/scope /dependency dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-alibaba-dependencies/artifactId version${spring-cloud-alibaba.version}/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement注意dependencyManagement里的import方式。它不像普通依賴那樣把 jar 直接引入而是把對應 BOM 里的版本管理信息導入當前 POM。這樣你在子模塊里寫依賴的時候可以不加versionMaven 會自動找父工程里鎖定的版本。2.3 子模塊的拆分方式父工程下我會建兩個子模塊分別對應兩個可啟動的服務spring-cloud-crud-demo ├── pom.xml # 父工程 ├── gateway-service/ # 網(wǎng)關服務 └── user-service/ # 用戶服務承載 CRUD 業(yè)務嚴格來說網(wǎng)關也是微服務的一個成員所以它也要注冊到 Nacos只是它的職責不是處理業(yè)務而是做路由轉(zhuǎn)發(fā)。兩個子模塊的pom.xml里只需聲明自身需要的依賴即可。user-service的依賴如下dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version${mybatis-plus.version}/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-starter-openfeign/artifactId /dependency /dependenciesgateway-service的依賴則要注意不要加spring-boot-starter-web。這一點我在后面會專門講Gateway 基于 WebFlux 響應式模型和傳統(tǒng)的 Servlet Web 容器沖突加了就啟動報錯。3. 注冊中心接入用 Nacos 讓服務先彼此看見3.1 為什么選擇 Nacos 而不是 EurekaEureka 2.x 已經(jīng)停止維護這已經(jīng)是共識。Nacos 是阿里巴巴開源的服務發(fā)現(xiàn)與配置管理組件目前在國內(nèi)微服務項目中占絕對主流。選它的理由很簡單既能做服務注冊發(fā)現(xiàn)又能做配置中心一套組件解決兩個問題而且和 Spring Cloud Alibaba 生態(tài)結(jié)合得非常順滑。后文如果繼續(xù)寫這個系列配置中心的整合就會直接基于 Nacos不需要額外引入新組件。3.2 本地啟動 Nacos ServerNacos Server 的啟動方式有源碼編譯、Docker、下載發(fā)行包三種。對于本地驗證我推薦直接下載最新穩(wěn)定版發(fā)行包# 解壓后進入 bin 目錄Linux/macOS 執(zhí)行 sh startup.sh -m standalone # Windows 執(zhí)行 startup.cmd -m standalonestandalone參數(shù)表示單機模式Nacos 默認使用內(nèi)置的 Derby 數(shù)據(jù)庫存儲服務實例信息不需要額外安裝數(shù)據(jù)庫。啟動成功后訪問http://127.0.0.1:8848/nacos默認用戶名密碼都是nacos能看到控制臺界面就說明注冊中心已經(jīng)就緒。3.3 user-service 接入 Nacosuser-service的application.yml中配置如下server: port: 8081 spring: application: name: user-service cloud: nacos: discovery: server-addr: 127.0.0.1:8848 namespace: public group: DEFAULT_GROUP datasource: url: jdbc:mysql://127.0.0.1:3306/crud_demo?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: auto幾個關鍵點解釋一下spring.application.name是服務在注冊中心里的唯一標識也是后面服務間調(diào)用和網(wǎng)關路由的關鍵依據(jù)。名字別亂起建議用中劃線分隔比如user-service而不是userService。namespace和group可以在沒有顯式配置時省略默認就是public和DEFAULT_GROUP。但我在實際項目里建議一開始就顯式寫出來因為后續(xù)做環(huán)境隔離dev/test/prod 各占一個 namespace時你會理解這兩個參數(shù)的意義。3.4 啟動類上加注解在UserServiceApplication上加上EnableDiscoveryClientSpringBootApplication EnableDiscoveryClient public class UserServiceApplication { public static void main(String[] args) { SpringApplication.run(UserServiceApplication.class, args); } }在 Spring Cloud 2021.x 版本里注冊發(fā)現(xiàn)能力已經(jīng)默認開啟不加這個注解也能注冊但我建議保留。原因有兩個一是顯式表明這個服務要參與服務發(fā)現(xiàn)二是如果你做一些自定義的注冊邏輯或者需要注入 DiscoveryClient 對象時這個注解會讓代碼意圖更清晰。啟動user-service后回到 Nacos 控制臺服務列表里應該能看到user-service已經(jīng)注冊上來狀態(tài)為健康。4. CRUD 三件套的實現(xiàn)實體、持久層、接口層微服務架構(gòu)下的業(yè)務代碼寫法其實和單體項目沒有本質(zhì)區(qū)別。這也是我特別想強調(diào)的一點Spring Cloud 的整合重點在基礎設施和通信鏈路而不是讓你把熟悉的 CRUD 寫法推翻重來。4.1 數(shù)據(jù)庫準備先準備一張簡單的用戶表CREATE DATABASE IF NOT EXISTS crud_demo DEFAULT CHARACTER SET utf8mb4; USE crud_demo; CREATE TABLE user ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主鍵ID, username VARCHAR(64) NOT NULL COMMENT 用戶名, email VARCHAR(128) DEFAULT NULL COMMENT 郵箱, phone VARCHAR(20) DEFAULT NULL COMMENT 手機號, created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 創(chuàng)建時間, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新時間, PRIMARY KEY (id) ) ENGINE InnoDB DEFAULT CHARSET utf8mb4 COMMENT 用戶表;這里有個字段命名的小細節(jié)數(shù)據(jù)庫字段用下劃線風格created_atJava 實體用駝峰風格createdAt。MyBatis-Plus 的map-underscore-to-camel-case配置會自動做映射省去大量手寫 ResultMap 的工作。我在 3.3 里的配置已經(jīng)打開了這個開關。4.2 實體類與 Mapper實體類對應表結(jié)構(gòu)Data TableName(user) public class User { TableId(type IdType.AUTO) private Long id; private String username; private String email; private String phone; private LocalDateTime createdAt; private LocalDateTime updatedAt; }TableName(user)注解是因為user這個表名不是 Java 命名規(guī)范的駝峰形式如果不注解MyBatis-Plus 會默認映射到user實體類名正好也能對上但為了保險起見還是顯式標注。Mapper 接口更簡單Mapper public interface UserMapper extends BaseMapperUser { }BaseMapperT是 MyBatis-Plus 提供的通用 CRUD Mapper內(nèi)置了selectById、insert、updateById、deleteById、selectList等方法。正常情況下你不需要寫任何 XML 映射文件也不需要寫 SQL 語句。這套寫法的好處是一個實體對應一個 MapperCRUD 的基礎方法全部開箱即用。4.3 Service 層的接口與實現(xiàn)Service 層建議按接口 實現(xiàn)類的模式拆開雖然代碼量多一些但在業(yè)務復雜后你會受益于這種隔離public interface UserService { User getUserById(Long id); Long createUser(User user); Boolean updateUser(User user); Boolean deleteUser(Long id); ListUser listUsers(); } Service RequiredArgsConstructor public class UserServiceImpl implements UserService { private final UserMapper userMapper; Override public User getUserById(Long id) { return userMapper.selectById(id); } Override public Long createUser(User user) { user.setCreatedAt(LocalDateTime.now()); user.setUpdatedAt(LocalDateTime.now()); userMapper.insert(user); return user.getId(); } Override public Boolean updateUser(User user) { user.setUpdatedAt(LocalDateTime.now()); return userMapper.updateById(user) 0; } Override public Boolean deleteUser(Long id) { return userMapper.deleteById(id) 0; } Override public ListUser listUsers() { return userMapper.selectList(null); } }注意構(gòu)造器注入的寫法。在 Spring 官方文檔里構(gòu)造器注入是推薦的依賴注入方式它讓依賴關系不可變、不容易產(chǎn)生循環(huán)依賴也方便單元測試。我早期寫 Spring 項目時習慣用Autowired字段注入直到一次排查空指針問題發(fā)現(xiàn)是依賴沒有初始化完成從那以后就轉(zhuǎn)向了構(gòu)造器注入。4.4 Controller 層與統(tǒng)一返回結(jié)構(gòu)Controller 層直接暴露 HTTP 接口但我不建議直接把實體返回給前端更規(guī)范的做法是引入一個統(tǒng)一返回體。這里用一個極簡的RT類Data public class RT { private Integer code; private String message; private T data; public static T RT ok(T data) { RT r new R(); r.setCode(200); r.setMessage(success); r.setData(data); return r; } public static T RT error(String message) { RT r new R(); r.setCode(500); r.setMessage(message); return r; } }Controller 如下RestController RequestMapping(/user) RequiredArgsConstructor public class UserController { private final UserService userService; GetMapping(/{id}) public RUser getUserById(PathVariable Long id) { return R.ok(userService.getUserById(id)); } PostMapping public RLong createUser(RequestBody User user) { return R.ok(userService.createUser(user)); } PutMapping public RBoolean updateUser(RequestBody User user) { return R.ok(userService.updateUser(user)); } DeleteMapping(/{id}) public RBoolean deleteUser(PathVariable Long id) { return R.ok(userService.deleteUser(id)); } GetMapping public RListUser listUsers() { return R.ok(userService.listUsers()); } }到這一步user-service已經(jīng)是一個具備完整 CRUD 能力的 HTTP 服務了。你可以直接用瀏覽器或者 Postman 訪問http://127.0.0.1:8081/user/1測試一下能返回 JSON 就說明業(yè)務側(cè)已經(jīng)跑通。但這不是微服務的完整形態(tài)接下來要做的是把服務納入網(wǎng)關并演示服務間如何調(diào)用。5. 網(wǎng)關與服務間調(diào)用請求鏈路的最后一公里5.1 Gateway 的角色定位與配置網(wǎng)關是微服務架構(gòu)里所有外部請求的統(tǒng)一入口。你可以把它理解成一個前臺收發(fā)室外面的人不知道每個辦公室服務具體在哪只要把快遞請求交給收發(fā)室收發(fā)室根據(jù)地址路由規(guī)則分發(fā)給對應的辦公室。創(chuàng)建gateway-service子模塊pom.xml引入dependency groupIdorg.springframework.cloud/groupId artifactIdspring-cloud-starter-gateway/artifactId /dependency dependency groupIdcom.alibaba.cloud/groupId artifactIdspring-cloud-starter-alibaba-nacos-discovery/artifactId /dependency配置文件server: port: 8080 spring: application: name: gateway-service cloud: nacos: discovery: server-addr: 127.0.0.1:8848 gateway: routes: - id: user-service-route uri: lb://user-service predicates: - Path/api/user/** filters: - StripPrefix1 logging: level: org.springframework.cloud.gateway: debug這里的路由配置拆開看id路由的唯一標識自定義即可。uri: lb://user-servicelb://前綴表示啟用負載均衡后面跟的是服務名Gateway 會從 Nacos 拉取user-service的實例列表并按負載均衡策略進行分發(fā)。predicates路由斷言Path/api/user/**表示以/api/user/開頭的請求都會命中這條路由。filters: StripPrefix1轉(zhuǎn)發(fā)到下游服務前去掉路徑中的第一級前綴。舉個例子外部請求GET http://127.0.0.1:8080/api/user/1經(jīng)過 Gateway 后StripPrefix1會去掉api變成/user/1然后轉(zhuǎn)發(fā)到user-service的/user/1接口。這樣前端調(diào)用可以統(tǒng)一帶/api前綴而每個微服務內(nèi)部接口不需要關心外部前綴是什么。5.2 為什么 Gateway 不能和 spring-boot-starter-web 共存這是一個高頻踩坑點。Gateway 底層基于 Spring WebFlux使用的是 Reactor Netty 響應式模型spring-boot-starter-web則是傳統(tǒng)的 Servlet 模型基于 Tomcat。兩者同時出現(xiàn)在類路徑下時Spring Boot 的自動配置會發(fā)生沖突典型報錯是Spring MVC found on classpath, which is incompatible with Spring Cloud Gateway解決方案只有一個gateway-service 的 pom.xml 里不要引入spring-boot-starter-web。如果你是從別的項目拷貝 pom 過來很容易帶出這個依賴啟動時報錯后需要仔細核對依賴樹mvn dependency:tree -Dincludesorg.springframework.boot:spring-boot-starter-web5.3 用 OpenFeign 實現(xiàn)服務間調(diào)用CRUD 場景里網(wǎng)關把請求路由到user-service就夠了但很多時候業(yè)務會有跨服務的數(shù)據(jù)需求。比如訂單服務需要查詢用戶信息這就涉及服務間調(diào)用。OpenFeign 是 Spring Cloud 生態(tài)里最主流的聲明式 HTTP 客戶端。先在一個獨立的模塊或者任意服務里定義 Feign 接口。這里為了演示我在user-service里加一個UserClient模擬被網(wǎng)關服務調(diào)用FeignClient(name user-service, path /user) public interface UserClient { GetMapping(/{id}) RUser getById(PathVariable(id) Long id); }FeignClient注解里的name是目標服務在注冊中心的服務名path是公共路徑前綴。方法定義和 Spring MVC Controller 的映射寫法一致OpenFeign 會在運行時動態(tài)生成實現(xiàn)類發(fā) HTTP 請求到目標服務的對應接口。調(diào)用方啟動類加上EnableFeignClientsEnableFeignClients SpringBootApplication public class SomeServiceApplication { public static void main(String[] args) { SpringApplication.run(SomeServiceApplication.class, args); } }然后就可以像注入普通 Service 一樣使用UserClientService public class OrderService { private final UserClient userClient; public User getUserInfo(Long userId) { return userClient.getById(userId); } }這里 OpenFeign 會配合負載均衡組件以服務名user-service從注冊中心拿到真實地址然后完成調(diào)用。整個過程對業(yè)務代碼完全透明你不需要關心目標服務的 IP 和端口。5.4 負載均衡策略的小知識在 Spring Cloud 2021.x 里原來的 Ribbon 客戶端已經(jīng)被 Spring Cloud LoadBalancer 取代。默認的負載均衡策略是輪詢Round Robin如果你需要改成隨機策略可以通過配置實現(xiàn)。不過在剛開始整合階段輪詢夠用了先跑通鏈路再說不要過早優(yōu)化策略。6. 本地完整啟動驗證與高頻踩坑記錄6.1 啟動順序很重要我把啟動流程固定下來按這個順序操作可以最大程度減少排查成本啟動 MySQL確認crud_demo庫和user表存在。啟動 Nacos Server瀏覽器訪問控制臺確認可用。啟動user-service確認 Nacos 服務列表中出現(xiàn)該服務。啟動gateway-service同樣確認注冊成功。通過網(wǎng)關發(fā)起請求驗證完整鏈路。驗證請求建議用這幾個# 新增用戶注意走網(wǎng)關端口 8080 curl -X POST http://127.0.0.1:8080/api/user \ -H Content-Type: application/json \ -d {username: test_user, email: testexample.com, phone: 13800000000} # 查詢用戶 curl http://127.0.0.1:8080/api/user/1 # 查詢所有用戶 curl http://127.0.0.1:8080/api/user # 更新用戶 curl -X PUT http://127.0.0.1:8080/api/user \ -H Content-Type: application/json \ -d {id: 1, username: updated_user, email: updatedexample.com} # 刪除用戶 curl -X DELETE http://127.0.0.1:8080/api/user/1如果刪掉了用戶記得再插一條數(shù)據(jù)做后續(xù)測試或者把刪除請求放到最后執(zhí)行。6.2 我實際遇到過的幾個問題問題一Nacos 注冊成功但 Gateway 轉(zhuǎn)發(fā)報 503這個問題的典型場景是user-service在 Nacos 里顯示健康但通過網(wǎng)關訪問時返回 503 Service Unavailable。排查步驟我也是踩了幾次坑才總結(jié)出來的先直接訪問http://127.0.0.1:8081/user/1確認服務本身健康。再檢查 Gateway 的配置重點看uri是不是lb://user-service拼寫是否正確。lb://不能少少了下游地址無法解析?？?Gateway 日志如果出現(xiàn)Unable to load instance之類的關鍵字多半是 Nacos 上服務的實例狀態(tài)異?？赡苁亲粤硕鄠€環(huán)境比如 dev 和 test 用了同一個 Nacos可以通過namespace隔離。問題二MyBatis-Plus 的 LocalDateTime 反序列化報錯前端傳 JSON 給后端后端返回 JSON 給前端LocalDateTime 字段會面臨序列化格式問題。如果不做配置返回的可能是數(shù)組形式的[2025, 3, 15, 10, 30, 0]前端解析會很痛苦。我在user-service里加了統(tǒng)一的 Jackson 配置spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8注意這個配置對LocalDateTime類型的字段不一定生效因為 LocalDateTime 默認是由 JSR310 模塊序列化的。為了穩(wěn)妥我在字段上添加了注解JsonFormat(pattern yyyy-MM-dd HH:mm:ss) private LocalDateTime createdAt;問題三啟動時端口被占本地調(diào)試多個微服務時端口沖突是?？?。Linux/macOS 用lsof -i :8081查看占用端口的進程Windows 用netstat -ano | findstr 8081。也可以直接把微服務的端口號都改成隨機端口server: port: 0但這樣服務名就成了唯一標識如果你后面調(diào)試時要通過固定端口訪問反而更麻煩。本地學習階段還是建議固定端口。問題四OpenFeign 調(diào)用時復雜對象參數(shù)丟失這是我曾經(jīng)疏忽的地方Feign 接口方法里如果有多個參數(shù)必須用PathVariable或者RequestParam顯式標注參數(shù)名。如果漏了注解編譯時參數(shù)名會被擦除導致請求發(fā)送出去后目標服務收到null。構(gòu)建時可以用-parameters參數(shù)保留元數(shù)據(jù)但最穩(wěn)妥的做法還是每個參數(shù)都加上對應注解。6.3 這篇整合對后續(xù)系列的意義到這里一個帶注冊發(fā)現(xiàn)、網(wǎng)關路由、服務間調(diào)用、全鏈路 CRUD 的微服務骨架已經(jīng)完成。你擁有了一個隨時可以擴展的基礎設施再加業(yè)務模塊時只需要新建一個子模塊寫上業(yè)務代碼注冊到 Nacos然后在網(wǎng)關里加一條路由即可。實際上這也是我寫這一篇整合的初衷。很多人覺得微服務難不是難在概念而是難在第一次把整套東西串起來。一旦串起來之后就會發(fā)現(xiàn)后端的治理組件配置中心、熔斷、鏈路追蹤都是在這個骨架上不斷做加法。下一篇整合我打算寫配置中心的接入也就是把user-service里的數(shù)據(jù)源配置挪到 Nacos 配置中心做到配置動態(tài)刷新。那件事做完之后你會對配置和代碼分離有更直觀的感受。7. 一組可以直接抄作業(yè)的工程配置清單為了照顧不同閱讀習慣的同學我把整個工程的關鍵配置以清單形式再匯總一遍。按照下面的清單核對基本可以避免遺漏。模塊配置文件關鍵配置項父工程 pom.xmlspring-cloud-dependencies2021.0.8統(tǒng)一管理 Spring Cloud 組件版本父工程 pom.xmlspring-cloud-alibaba-dependencies2021.0.5.0統(tǒng)一管理 Nacos 等 Alibaba 組件版本user-serviceapplication.ymlnacos discovery、datasource、mybatis-plus 配置user-servicepom.xmlstarter-web、nacos-discovery、mybatis-plus、openfeign、mysqlgateway-serviceapplication.ymlnacos discovery、gateway routes含 StripPrefix1gateway-servicepom.xmlstarter-gateway、nacos-discovery不引入 starter-web依賴與注解方面的核對點如下啟動類上要有SpringBootApplication需要注冊發(fā)現(xiàn)就加EnableDiscoveryClient需要 Feign 就加EnableFeignClients。Mapper注解讓 MyBatis 掃描到 Mapper 接口或者在啟動類上使用MapperScan(com.example.mapper)批量掃描。Controller 層統(tǒng)一返回RT后續(xù)加全局異常處理器時才能保證異常和正常返回的結(jié)構(gòu)一致。Gateway 路由配置中l(wèi)b://前綴表示負載均衡服務名要和 Nacos 上注冊的一致。8. 關于這個骨架我還想強調(diào)的幾件事第一微服務整合不是越復雜越好?，F(xiàn)在 Spring Cloud 生態(tài)里的組件非常多熔斷、限流、鏈路跟蹤、分布式事務各有各的場景。但如果你剛起步就把這些全部引入任何一個環(huán)節(jié)出問題排查起來都會非常痛苦。先維護一個最小可用的鏈路是我驗證過最穩(wěn)妥的推進方式。第二本地調(diào)試時日志就是最好的老師。我在本地調(diào)試時會把 MyBatis-Plus 的 SQL 日志打開3.3 配置里的log-impl也把 Gateway 的日志級別調(diào)成 debug。這樣做的好處是請求到達哪個環(huán)節(jié)、SQL 執(zhí)行了什么、路由轉(zhuǎn)發(fā)到了哪里全部一目了然。很多同學遇到 500 錯誤就發(fā)懵其實把日志翻一翻很多問題都能找到答案。第三關于 OpenFeign 和 Gateway 的整合順序我見過有些人先做網(wǎng)關后做 Feign導致調(diào)試時鏈路太多分不清問題在哪。我建議的順序是先直連確認服務本身沒問題再通過 Feign 做服務間調(diào)用最后接入網(wǎng)關統(tǒng)一入口。一步一步驗證每一步的結(jié)論都是確定的這樣最終鏈路出問題時可以迅速定位是哪個環(huán)節(jié)引入的。這篇文章到這里Spring Cloud 整合 CRUD 就已經(jīng)全部跑通了。整個過程中我刻意避開了那些炫技式的高級配置只保留必需的部分。理由很簡單你先把這條最基礎的鏈路走通下一篇文章在配置中心里改數(shù)據(jù)源配置時才能意識到什么叫改動一處服務不重啟。那才是微服務治理真正有意思的開始。