第九章 FAQ · SpringBlade開發手冊

**一、Blade技術社區建立以來已經解決了數以百計的問題，為了讓大家更快的排坑，特將常見的問題收錄，供大家快速查閱。** **二、常見問題集錦** **1\. 工程運行報錯：java.lang.RuntimeException: Driver com.mysql.cj.jdbc.Driver claims to not accept jdbcUrl, ${blade.datasource.dev.url}** 答：這是因為nacos沒有配置好，具體說明請看：[https://sns.bladex.cn/q-41.html](https://sns.bladex.cn/q-41.html) **2.int類型的空字段返回的json值為-1** 答：框架針對null值做了統一序列化處理，具體說明請看：[https://sns.bladex.cn/q-100.html](https://sns.bladex.cn/q-100.html) **3.Saber和Sword打包部署后無法訪問** 答：需要部署至nginx并配置反向代理，具體說明請看：[https://sns.bladex.cn/q-184.html](https://sns.bladex.cn/q-184.html) **4.接口返回未授權** 答：框架內部鑒權，需要增加Blade-Auth請求頭，具體說明請看：開源版：[http://www.hmoore.net/smallchill/blade/913216](http://www.hmoore.net/smallchill/blade/913216) 商業版：參考手冊《OAuth2認證系統》章節 **5.如何對接口進行放行** 答：可根據對應配置進行鑒權放行，具體說明請看：[https://sns.bladex.cn/q-124.html](https://sns.bladex.cn/q-124.html) 注：商業版已實現網關鑒權，具體參考手冊《鑒權配置》章節 **6.微信、XML格式的數據被過濾** 答：框架自帶了xss防注入功能，需要配置放行，具體說明請看：[https://sns.bladex.cn/q-112.html](https://sns.bladex.cn/q-112.html) **7.Swagger在生產環境無法使用** 答：為了保證接口文檔的安全，禁用了生產環境的加載，具體說明請看：[https://sns.bladex.cn/q-39.html](https://sns.bladex.cn/q-39.html) **8.框架的多數據源如何處理** 答：可以考慮插件 mybatis-plus-dynamicdatasource，具體說明請看：[https://sns.bladex.cn/q-74.html](https://sns.bladex.cn/q-74.html) **9.框架如何使用讀寫分離** 答：可以使用數據庫中間件 ShardingSphere，具體說明請看：[https://sns.bladex.cn/article-14953.html](https://sns.bladex.cn/article-14953.html) **10.?OAuth2用密碼模式授權返回錯誤信息為Full authentication is required to access this resource** 答：可能出現的問題有很多種，具體說明請看： [https://sns.bladex.cn/q-51.html](https://sns.bladex.cn/q-51.html) [https://sns.bladex.cn/q-265.html](https://sns.bladex.cn/q-265.html) **11.前端列表返回的主鍵最后兩位變成了0** 答：long類型的主鍵長度過長，到前端js精度缺失，具體說明請看：[https://sns.bladex.cn/q-344.html](https://sns.bladex.cn/q-344.html) **12.eclipse下啟動遇到問題，配置文件沒有自動生成** 答：使用了java spi機制，eclipse有些情況下支持不好，只能用常規的方式解決，具體說明請看：[https://sns.bladex.cn/q-116.html](https://sns.bladex.cn/q-116.html) **13.運行單元測試報錯** 答：blade啟動引用到了環境變量，需要使用自定義的注解，具體說明請看：[https://sns.bladex.cn/q-352.html](https://sns.bladex.cn/q-352.html) **14.node-sass安裝失敗** 答：環境影響會導致多種問題，具體可以按照這個帖子排查：[https://www.jianshu.com/p/92afe92db99f](https://www.jianshu.com/p/92afe92db99f)?、?[https://www.jianshu.com/p/828de2cb9855](https://www.jianshu.com/p/828de2cb9855) **15.項目運行提示 no available server to connect** 答：系統集成了seata分布式事務，需要啟動對應服務，具體說明請看：[https://sns.bladex.cn/q-619.html](https://sns.bladex.cn/q-619.html) **16.不同包名如何配置mybatis、feign** 答：需要做包名掃描，具體說明請看：[https://sns.bladex.cn/q-630.html](https://sns.bladex.cn/q-630.html) **17.登錄提示“未獲得用戶的角色信息”** 答：一般是boot、cloud混合啟動后導致的問題，也有可能是老版本升級的問題，具體說明請看：[https://sns.bladex.cn/q-632.html](https://sns.bladex.cn/q-632.html) **18.bladex無法下載maven私服的jar包** 答：有時候maven配置會導致這個問題，具體說明請看：[https://sns.bladex.cn/q-762.html](https://sns.bladex.cn/q-762.html) **19.IDEA開啟多服務批量啟動** 答：開啟后可以方便批量啟動，具體說明請看：[https://sns.bladex.cn/q-765.html](https://sns.bladex.cn/q-765.html) **20.Avue如何進行表單字段自定義動態賦值** 答：需要對綁定的值域進行操作，具體說明請看：[https://sns.bladex.cn/q-781.html](https://sns.bladex.cn/q-781.html) **21.Windows平臺部署失敗，nacos配置讀取失敗** 答：win平臺的字符編碼問題導致，具體說明請看：[https://sns.bladex.cn/q-875.html](https://sns.bladex.cn/q-875.html) **22.前端工程IE不兼容** 答：這是個老生常談的問題，具體說明請看：[https://sns.bladex.cn/q-872.html](https://sns.bladex.cn/q-872.html) **23.webstorm不識別vue-cli內的@符號** 答：需要進行配置，具體說明請看：[https://sns.bladex.cn/q-881.html](https://sns.bladex.cn/q-881.html) **24.BladeX相關項目說明** 答：做了具體說明，為大家解惑，具體請看：[https://sns.bladex.cn/q-888.html](https://sns.bladex.cn/q-888.html) **25.Avue表格樣式錯層** 答：需要做一下對齊，具體請看：[https://sns.bladex.cn/q-897.html](https://sns.bladex.cn/q-897.html) **26.新建用戶分配了權限，但是有些菜單點擊提示未授權并返回到了登錄頁** 答：這是系統的安全機制，有些接口設定了只有超管、管理員才能訪問，具體請看：[https://sns.bladex.cn/q-1033.html](https://sns.bladex.cn/q-1033.html) **27\. postman快速導入json配置文件來調用oauth2接口** 答：不少用戶在調用oauth2接口的時候都會出錯，現在導出配置文件，可直接調用，具體請看：[https://sns.bladex.cn/article-14982.html](https://sns.bladex.cn/article-14982.html) **28\. 字典封存是什么意思** 答：字典封存的具體解答請看：[https://sns.bladex.cn/q-1270.html](https://sns.bladex.cn/q-1270.html) **29\. 內外網注冊到Nacos聯調** 答：需要做ip外網映射以及啟動指定ip，具體請看：[](https://sns.bladex.cn/q-1270.html)[https://sns.bladex.cn/q-1233.html](https://sns.bladex.cn/q-1233.html) ****30\. java.lang.NoClassDefFoundError: com/baomidou/mybatisplus/generator/config/ITypeConvert**** 答：根據不同的開發環境，會有不同的表現結果，具體請看：[https://sns.bladex.cn/q-1350.html](https://sns.bladex.cn/q-1350.html) **31\. org.springframework.http.converter.HttpMessageConversionException: JSON conversion problem: Invalid UTF-8 middle byte 0xd0** 答：服務器編碼問題導致，具體請看：[https://sns.bladex.cn/q-1391.html](https://sns.bladex.cn/q-1391.html) **32\. Invalid bound statement (not found): org.springblade.core.mp.mapper.BladeMapper.selectOne** 答：自定義了包名沒有做掃描導致的問題，具體請看：[](https://sns.bladex.cn/q-1391.html)[https://sns.bladex.cn/q-1373.html](https://sns.bladex.cn/q-1373.html) **33\. 遠程調用Feign譬如返回IPage、INode會直接進入FallBack** 答：消費者端進行返回數據序列化導致的錯，具體請看：[https://sns.bladex.cn/q-1512.html](https://sns.bladex.cn/q-1512.html) **34\. org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.exceptions.PersistenceException:?** **\### Error querying database.? Cause: org.springframework.jdbc.BadSqlGrammarException: PreparedStatementCallback; bad SQL grammar \[select resource\_code, scope\_column, scope\_field, scope\_type, scope\_value from blade\_scope\_data where scope\_class = ? and id in (select scope\_id from blade\_role\_scope where scope\_category = 1 and role\_id in ())\]** 答：一般是沒有分配token，或者沒有給用戶分配角色，具體請看：[https://sns.bladex.cn/q-1595.html](https://sns.bladex.cn/q-1595.html) **35\. org.springframework.beans.factory.BeanDefinitionStoreException: Failed to process import candidates for configuration class \[org.springblade.gateway.GateWayApplication\]; nested exception is java.io.FileNotFoundException: class path resource \[org/springframework/web/servlet/config/annotation/WebMvcConfigurer.class\] cannot be opened because it does not exist** 答：gateway是webflux，不可引入web，具體請看：[https://sns.bladex.cn/q-1583.html](https://sns.bladex.cn/q-1583.html) **36\. Saber部署不在根目錄，有一個前綴，部署后訪問資源404** 答：需要在vue.config.js進行配置，具體請看：[https://sns.bladex.cn/q-1493.html](https://sns.bladex.cn/q-1493.html) **37\. Mybatis-Plus邏輯刪除、自動填充拓展** 答：有一些注意點，具體請看：[https://sns.bladex.cn/q-1395.html](https://sns.bladex.cn/q-1395.html)，[https://sns.bladex.cn/q-1394.html](https://sns.bladex.cn/q-1394.html) **38\. 日志系統調用流程** 答：主要通過Spring-Event進行解耦，具體流程請看：[https://sns.bladex.cn/q-1657.html](https://sns.bladex.cn/q-1657.html) **39\. Saber內網部署圖標不顯示** 答：Saber默認連接了在線的圖標庫，若需要部署到內網環境，具體請看：[https://sns.bladex.cn/q-1768.html](https://sns.bladex.cn/q-1768.html) **40\. GateWay映射服務原理** 答：有一些注意點，具體請看：[https://sns.bladex.cn/q-1771.html](https://sns.bladex.cn/q-1771.html) **41\. 數據大屏應用搭建流程** 答：有較多用戶有這個疑問，具體請看：[https://sns.bladex.cn/article-14988.html](https://sns.bladex.cn/article-14988.html) **42\. Saber安裝出錯** 答：一般是本機環境缺失導致，具體請看：[https://sns.bladex.cn/q-1825.html](https://sns.bladex.cn/q-1825.html) **42\. Docker構建字體慢** 答：需要配置加速鏡像，具體請看：[https://sns.bladex.cn/q-3090.html](https://sns.bladex.cn/q-3090.html) **43\. 部署在centos后，隔一段時間上傳文件報錯** 答：需要額外加一段配置以防止臨時目錄被清空，具體請看：[https://sns.bladex.cn/article-14995.html](https://sns.bladex.cn/article-14995.html) **44.?RPC failed curl 92 HTTP/2 stream 0 was not closed cleanly: PROTOCOL\_ERROR** 答：git上傳文件容量或http版本導致的問題，具體請看：[https://sns.bladex.cn/q-4131.html](https://sns.bladex.cn/q-4131.html) **45\. 前端部署后緩存嚴重，無法自動刷新** 答：需要在nginx與webpack做些許配置，具體請看：[https://sns.bladex.cn/q-4150.html](https://sns.bladex.cn/q-4150.html) **46\. 分庫后數據權限獲取不到表從而報錯** 答：分庫后數據權限表不在業務表，需要做額外配置，具體請看：[https://sns.bladex.cn/q-591.html](https://sns.bladex.cn/q-591.html)、[https://sns.bladex.cn/q-6231.html](https://sns.bladex.cn/q-6231.html) **47.?Saber自定義search表單后獲取表單組件內容** 答：2.8.x版本后推薦使用新版API，具體請看：[https://sns.bladex.cn/q-4370.html](https://sns.bladex.cn/q-4370.html) **48\. Mybatis-Plus更新方法updateById如何讓null字段生效** 答：有三種方式，具體請看：[https://sns.bladex.cn/q-4409.html](https://sns.bladex.cn/q-4409.html) **49\. Saber內baseUrl的用法** 答：默認使用反向代理配置，若需要baseUrl配置請看：[https://sns.bladex.cn/q-4292.html](https://sns.bladex.cn/q-4292.html) **50\. Saber同一路由不同參數訪問的刷新問題** 答：需要做watch監聽，具體請看：[https://sns.bladex.cn/q-4494.html](https://sns.bladex.cn/q-4494.html) **51.?adoptopenjdk/openjdk8-openj9:alpine-slim 鏡像報錯** 答：官方會實時更新，有時候的確會出問題，可以指定tag版本解決，具體請看：[https://sns.bladex.cn/q-4608.html](https://sns.bladex.cn/q-4608.html) **52\. SpringBoot版本如何配置靜態資源** 答：需要配置resource以及接口放行，具體請看：[https://sns.bladex.cn/q-4623.html](https://sns.bladex.cn/q-4623.html) **53\. 多租戶數據庫隔離場景下定時任務切換數據源的問題** 答：需要使用dynamic-datasource自帶工具類，自定義租戶id來切換數據源，具體請看：[https://sns.bladex.cn/q-5045.html](https://sns.bladex.cn/q-5045.html) **54\. war打包tomcat運行部署** 答：需要做undertow排除并重寫啟動器，具體請看：[https://sns.bladex.cn/q-6813.html](https://sns.bladex.cn/q-6813.html) **55\. sentinel日志配置** 答：修改源碼或者命令行啟動配置，具體請看：[https://sns.bladex.cn/q-569.html](https://sns.bladex.cn/q-569.html) **56\. Mybatis-Plus雪花ID主鍵生成重復** 答：額外做新的配置，具體請看：[https://sns.bladex.cn/q-8896.html](https://sns.bladex.cn/q-8896.html) **57\. 請配置 blade.token.sign-key 的值, 長度32位以上** 答：關閉了默認的token簽名，需要自行設置，具體請看：[https://sns.bladex.cn/q-9612.html](https://sns.bladex.cn/q-9612.html) 不斷完善中..... **三、BladeX商業授權** BladeX是SpringBlade的商業版框架，集成了更多功能，針對架構做了全面提升，是個人學習、企業開發的更優選擇。授權地址如下，歡迎選購：[https://bladex.cn/#/vip](https://bladex.cn/#/vip)