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

2.int类型的空字段返回的json值为-1

答：框架针对null值做了统一序列化处理，具体说明请看：https://sns.bladex.cn/q-100.html

3.Saber和Sword打包部署后无法访问

答：需要部署至nginx并配置反向代理，具体说明请看：https://sns.bladex.cn/q-184.html

4.接口返回未授权

答：框架内部鉴权，需要增加Blade-Auth请求头，具体说明请看：

开源版：https://www.kancloud.cn/smallchill/blade/913216

商业版：参考手册《OAuth2认证系统》章节

5.如何对接口进行放行

答：可根据对应配置进行鉴权放行，具体说明请看：https://sns.bladex.cn/q-124.html

注：商业版已实现网关鉴权，具体参考手册《鉴权配置》章节

6.微信、XML格式的数据被过滤

答：框架自带了xss防注入功能，需要配置放行，具体说明请看：https://sns.bladex.cn/q-112.html

7.Swagger在生产环境无法使用

答：为了保证接口文档的安全，禁用了生产环境的加载，具体说明请看：https://sns.bladex.cn/q-39.html

8.框架的多数据源如何处理

答：可以考虑插件 mybatis-plus-dynamicdatasource，具体说明请看：https://sns.bladex.cn/q-74.html

9.框架如何使用读写分离

答：可以使用数据库中间件 ShardingSphere，具体说明请看：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-265.html

11.前端列表返回的主键最后两位变成了0

答：long类型的主键长度过长，到前端js精度缺失，具体说明请看：https://sns.bladex.cn/q-344.html

12.eclipse下启动遇到问题，配置文件没有自动生成

答：使用了java spi机制，eclipse有些情况下支持不好，只能用常规的方式解决，具体说明请看：https://sns.bladex.cn/q-116.html

13.运行单元测试报错

答：blade启动引用到了环境变量，需要使用自定义的注解，具体说明请看：https://sns.bladex.cn/q-352.html

14.node-sass安装失败

答：环境影响会导致多种问题，具体可以按照这个帖子排查：https://www.jianshu.com/p/92afe92db99f 、 https://www.jianshu.com/p/828de2cb9855

15.项目运行提示 no available server to connect

答：系统集成了seata分布式事务，需要启动对应服务，具体说明请看：https://sns.bladex.cn/q-619.html

16.不同包名如何配置mybatis、feign

答：需要做包名扫描，具体说明请看：https://sns.bladex.cn/q-630.html

17.登录提示“未获得用户的角色信息”

答：一般是boot、cloud混合启动后导致的问题，也有可能是老版本升级的问题，具体说明请看：https://sns.bladex.cn/q-632.html

18.bladex无法下载maven私服的jar包

答：有时候maven配置会导致这个问题，具体说明请看：https://sns.bladex.cn/q-762.html

19.IDEA开启多服务批量启动

答：开启后可以方便批量启动，具体说明请看：https://sns.bladex.cn/q-765.html

20.Avue如何进行表单字段自定义动态赋值

答：需要对绑定的值域进行操作，具体说明请看：https://sns.bladex.cn/q-781.html

21.Windows平台部署失败，nacos配置读取失败

答：win平台的字符编码问题导致，具体说明请看：https://sns.bladex.cn/q-875.html

22.前端工程IE不兼容

答：这是个老生常谈的问题，具体说明请看：https://sns.bladex.cn/q-872.html

23.webstorm不识别vue-cli内的@符号

答：需要进行配置，具体说明请看：https://sns.bladex.cn/q-881.html

24.BladeX相关项目说明

答：做了具体说明，为大家解惑，具体请看：https://sns.bladex.cn/q-888.html

25.Avue表格样式错层

答：需要做一下对齐，具体请看：https://sns.bladex.cn/q-897.html

26.新建用户分配了权限，但是有些菜单点击提示未授权并返回到了登录页

答：这是系统的安全机制，有些接口设定了只有超管、管理员才能访问，具体请看：https://sns.bladex.cn/q-1033.html

27. postman快速导入json配置文件来调用oauth2接口

答：不少用户在调用oauth2接口的时候都会出错，现在导出配置文件，可直接调用，具体请看：https://sns.bladex.cn/article-14982.html

28. 字典封存是什么意思

答：字典封存的具体解答请看：https://sns.bladex.cn/q-1270.html

29. 内外网注册到Nacos联调

答：需要做ip外网映射以及启动指定ip，具体请看：https://sns.bladex.cn/q-1233.html

30. java.lang.NoClassDefFoundError: com/baomidou/mybatisplus/generator/config/ITypeConvert

答：根据不同的开发环境，会有不同的表现结果，具体请看：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

32. Invalid bound statement (not found): org.springblade.core.mp.mapper.BladeMapper.selectOne

答：自定义了包名没有做扫描导致的问题，具体请看：https://sns.bladex.cn/q-1373.html

33. 远程调用Feign譬如返回IPage、INode会直接进入FallBack

答：消费者端进行返回数据序列化导致的错，具体请看：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

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

36. Saber部署不在根目录，有一个前缀，部署后访问资源404

答：需要在vue.config.js进行配置，具体请看：https://sns.bladex.cn/q-1493.html

37. Mybatis-Plus逻辑删除、自动填充拓展

答：有一些注意点，具体请看：https://sns.bladex.cn/q-1395.html ，https://sns.bladex.cn/q-1394.html

38. 日志系统调用流程

答：主要通过Spring-Event进行解耦，具体流程请看：https://sns.bladex.cn/q-1657.html

39. Saber内网部署图标不显示

答：Saber默认连接了在线的图标库，若需要部署到内网环境，具体请看：https://sns.bladex.cn/q-1768.html

40. GateWay映射服务原理

答：有一些注意点，具体请看：https://sns.bladex.cn/q-1771.html

41. 数据大屏应用搭建流程

答：有较多用户有这个疑问，具体请看：https://sns.bladex.cn/article-14988.html

42. Saber安装出错

答：一般是本机环境缺失导致，具体请看：https://sns.bladex.cn/q-1825.html

42. Docker构建字体慢

答：需要配置加速镜像，具体请看：https://sns.bladex.cn/q-3090.html

43. 部署在centos后，隔一段时间上传文件报错

答：需要额外加一段配置以防止临时目录被清空，具体请看：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

45. 前端部署后缓存严重，无法自动刷新

答：需要在nginx与webpack做些许配置，具体请看：https://sns.bladex.cn/q-4150.html

46. 分库后数据权限获取不到表从而报错

答：分库后数据权限表不在业务表，需要做额外配置，具体请看：https://sns.bladex.cn/q-591.html、https://sns.bladex.cn/q-6231.html

47. Saber自定义search表单后获取表单组件内容

答：2.8.x版本后推荐使用新版API，具体请看：https://sns.bladex.cn/q-4370.html

48. Mybatis-Plus更新方法updateById如何让null字段生效

答：有三种方式，具体请看：https://sns.bladex.cn/q-4409.html

49. Saber内baseUrl的用法

答：默认使用反向代理配置，若需要baseUrl配置请看：https://sns.bladex.cn/q-4292.html

50. Saber同一路由不同参数访问的刷新问题

答：需要做watch监听，具体请看：https://sns.bladex.cn/q-4494.html

51. adoptopenjdk/openjdk8-openj9:alpine-slim 镜像报错

答：官方会实时更新，有时候的确会出问题，可以指定tag版本解决，具体请看：https://sns.bladex.cn/q-4608.html

52. SpringBoot版本如何配置静态资源

答：需要配置resource以及接口放行，具体请看：https://sns.bladex.cn/q-4623.html

53. 多租户数据库隔离场景下定时任务切换数据源的问题

答：需要使用dynamic-datasource自带工具类，自定义租户id来切换数据源，具体请看：https://sns.bladex.cn/q-5045.html

54. war打包tomcat运行部署

答：需要做undertow排除并重写启动器，具体请看：https://sns.bladex.cn/q-6813.html

55. sentinel日志配置 

答：修改源码或者命令行启动配置，具体请看：https://sns.bladex.cn/q-569.html

56. Mybatis-Plus雪花ID主键生成重复 

答：额外做新的配置，具体请看：https://sns.bladex.cn/q-8896.html

57. 请配置 blade.token.sign-key 的值, 长度32位以上

答：关闭了默认的token签名，需要自行设置，具体请看：https://sns.bladex.cn/q-9612.html

58. Saber3部署后刷新页面变成404

答：vue3版本路由需要额外加一个配置，具体请看：https://sns.bladex.cn/q-10566.html

59. 物联网平台设备连接密钥说明

答：连接密钥需要设备端通过各参数加密后生成，具体请看：https://sns.bladex.cn/q-13172.html

60. 验证码无法正确显示

答：可能是没有安装字体或者字体路径错误的问题，具体请看：https://sns.bladex.cn/q-13246.html

不断完善中.....

三、BladeX商业授权

BladeX是SpringBlade的商业版框架，集成了更多功能，针对架构做了全面提升，是个人学习、企业开发的更优选择。

授权地址如下，欢迎选购：https://bladex.cn/#/vip

联系我们：