# 后端相关 ### Maven依赖拉取不下来 - 更换网络环境、清空本地repository仓库或使用 [阿里公共仓库镜像](https://help.aliyun.com/document_detail/102512.html?spm=a2c40.aliyun_maven_repo.0.0.36183054dw7zZy) ### 更新项目代码后报错 - 可能已更新sql文件,请重新导入xboot.sql,并清空Redis(相关)缓存 ### 管理员账密 - admin 123456 ### 没找到登录`/login`相关接口 - 安全框架使用 [Spring Security](https://github.com/spring-projects/spring-security),请先了解学习其基本使用 ### 修改数据库数据后数据未生效 - 请同步清空Redis缓存,项目已有代码中已加入大量缓存设计 ### JPA未自动生成表结构 - 1. 若已运行项目请检查热更新插件是否生效,尝试手动重启项目 - 2. 若重启项目后仍未自动生成表,请检查定义的字段名称是否合法(检查日志中是否有相关日志打印) ### 后端运行报错:`...you have not installed the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files in this Java Virtual Machine` - 配置文件加解密需要 - 方案一:配置先全部直接使用明文 - 方案二:请更新JDK为对应版本的最新版,或去Oracle官网下载相应的JCE包 ### MySQL无法存储emoji、不常用汉字等特殊Unicode字符 - 当然可修改数据库所有编码默认为`utf8mb4`,为了节省空间,建议请修改具体需要的字符型字段的编码及排序规则为`utf8mb4`即可,如: ```sql ALTER TABLE 表名 MODIFY COLUMN 列名 varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ``` ### JRebel控制台报错:`JRebel: ERROR Class 'org.springframework.boot.context.properties.ConfigurationPropertiesBindingPostProcessor...'` - JRebel插件相关报错,说明插件版本较低,升级JRebel插件至最新版即可 ### JRebel热更新未生效 - 请手动点击编译按钮或编译器中配置更新策略 <img src="https://ooo.0o0.ooo/2020/04/27/mLtDBlNpuAkh3sn.png" width="600px"/> ### 如何实现多数据源 - 推荐使用该开源组件 https://dynamic-datasource.com/guide ### 部署后返回数据中文乱码 - 若打包部署后返回的数据中文出现乱码,请运行时加上参数 `-Dfile.encoding=utf-8`(添加至java -jar后),如`java -jar -Dfile.encoding=utf-8 XXX.jar` ### MySQL数据库远程连接慢 - 尝试配置`skip_name_resolve` ### 本地配置定位Api后无法获取到IP信息 - 本地开发时无法获取到真实IP,上线后才能获取到客户端IP --- # 前端相关 ### 项目启动报错 - 确保安装依赖过程中npm i没有报错,可删除node_modules以及package-lock.json重新npm i尝试,推荐尝试使用yarn或者cnpm安装依赖 ### 添加菜单后未显示 - 1. 请确保该一级菜单至少包含一个子级菜单 - 2. 记得为该用户拥有的角色分配该菜单权限,“系统管理-角色管理”中“菜单权限”按钮分配即可 ### 添加一级菜单后没有显示 - 在菜单管理中为该一级菜单再添加一个子级菜单,并将该一级菜单配置为始终显示 ### 添加一级和二级菜单后只显示了二级 - 在菜单管理中将其一级菜单配置为始终显示 ### 如何添加更多级菜单? - 目前暂限制添加三级菜单(包含顶部菜单),如需更多级请考虑其他方式:推荐使用`Tab`组件或`Menu`等组件,参考`系统监控-操作日志`或`XBoot业务组件`菜单页面,将每个子级页面内容封装成单独组件即可,用户使用体验更佳 ### 页面标签有缓存 - 不想要缓存的页面还可以在`/src/store/modules/app.js`中的`dontCache`配置,或者修改vue组件name与菜单管理中配置的路由英文名name不同 ### 页面标签缓存未生效 - 请确保Vue组件name与菜单管理中配置的路由英文名name相同 ### 浏览器`Vue-Devtools`开发插件在该项目中无法正常使用 - 因该项目已启用CDN,可参考前端部署优化部分进行逆向操作移除CDN;或替换CDN链接不要使用压缩版min.js,改为vue.js即可 --- # 工作流相关 ### 模型设计器加载404 - 本地开发时系统配置菜单中部署域名直接填入后端接口地址`http://127.0.0.1:8888`,填写后需刷新页面重新读取 ### 部署后字符乱码 - 若部署后流程图中文字符无法显示,是因为服务器环境jdk中无相应中文字体,百度安装即可(配置文件已配置微软雅黑,默认宋体) > 其他问题详见文档完整版开发指南中的Activiti部分