# 后端相關 ### 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部分