## 簡介 * Swagger作為接口文檔工具接入springboot工程非常方便，只需maven繼承官方的jar，實現一個configuration就可集成完畢 * 但是對于有較多微服務的系統來說，一個服務一個文檔地址，便會覺得比較麻煩。這時候聚合文檔的解決方案出現了，將所有的微服務地址以swagger分組的形式展現，切換分組的時候就相當于直接切換了整個微服務。 * JPower對聚合文檔做了優化，提供了非常簡單、配置方便的解決方案，我們來看看具體如何操作。 ## 如何配置 * 在nacos中配置好`jpower-api.yaml`文件。  * 在微服務服務工程引入common-swagger依賴即可  * 啟動jpower-api服務  ## 訪問文檔 * 啟動工程訪問文檔聚合地址： http://localhost:18000/doc.html  * 點擊左上角的下拉框，我們可以看到已經配置好了4個不同的微服務文檔。  * JPower集成了swagger增強插件knife4j，并已經實現了鑒權的header頭，我們只需要再header頭中輸入鑒權接口返回的值即可。需要注意的是每個微服務模塊都需要設置header頭的值。設置heaer值之后訪問接口無需再配置鑒權的token  ## 注意點 * swagger默認在生產環境 prod 下關閉無法使用，因為在生產環境暴露接口會非常危險，若需要開啟，可以到對應文件刪掉配置  * 每個服務都需要開啟knife4j配置，否則聚合文檔不會顯示服務接口，具體開啟文檔的配置如下： ~~~ #knife4j配置 knife4j: #啟用 enable: true ~~~ ## API直達 * swagger文檔直達：https://swagger.io/ * swagger增強插件knife4j有不少好用的功能，詳細說明和使用請查閱官方文檔：https://doc.xiaominfo.com/guide/useful.html