第九章 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请求头，具体说明请看：开源版：[https://www.kancloud.cn/smallchill/blade/913216](https://www.kancloud.cn/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)