中国 帮助

常见问题

这一章分为两部分: 官方 FAQ:来自 RuoYiVuePlus 5.X,原样保留,覆盖启动、登录、依赖、中间件、接口文档等通用问题; 平台 FAQ:无界平台自研功能相关的问题,见[平台常见问题](/docs/wujies/5.x/q

常见问题
封面

> 本文整理自平台文档 docs/wujies/5.x/questions/index.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-6fb6cd07b04e-cover.svg)

这一章分为两部分:

  • 官方 FAQ:来自 RuoYi-Vue-Plus 5.X,原样保留,覆盖启动、登录、依赖、中间件、接口文档等通用问题;
  • 平台 FAQ:无界平台自研功能相关的问题,见[平台常见问题](/docs/wujies/5.x/questions/platform-faq)。

遇到报错时,先按下面的分类定位;找不到再用右上角搜索关键词(异常类名、配置项、报错原文通常最有效)。

环境与启动

问题说明
[打包 jar 运行报错](/docs/wujies/5.x/questions/jar_run_fail)jar 启动失败的常见原因
[Lombok 注解爆红](/docs/wujies/5.x/questions/lombok)IDEA 插件与编译配置
[如何对接国产数据库](/docs/wujies/5.x/questions/domestic_databases)达梦、人大金仓等适配
[关于 HTTPS 配置](/docs/wujies/5.x/questions/https_config)证书与反向代理
[无法读取 nacos 配置](/docs/wujies/5.x/questions/nacos_read_fail)命名空间、分组、DataId
[Nacos 服务下线报错](/docs/wujies/5.x/questions/nacos_naming_instance_metadata)naming_instance_metadata Raft 报错
[如何指定 dubbo 注册 IP](/docs/wujies/5.x/questions/dubbo_ip)多网卡环境

登录与权限

问题说明
[关于登录调试步骤](/docs/wujies/5.x/questions/login_step)从账号密码到 token 的排查路径
[放行接口提示认证失败](/docs/wujies/5.x/questions/identify_fail)白名单配置未生效
[不支持 ST 请求](/docs/wujies/5.x/questions/st_not_support)Sa-Token 会话模式
[Redis 报错 Permission denied](/docs/wujies/5.x/questions/permission_denied)Redis 持久化目录权限

依赖与序列化

问题说明
[JCE cannot authenticate the provider BC](/docs/wujies/5.x/questions/jce_cannot)BouncyCastle 签名校验失败
[实体 bean 为空问题](/docs/wujies/5.x/questions/bean_null)拷贝、映射、序列化
[unable to read meta-data for class xxx](/docs/wujies/5.x/questions/read_metadata)注解处理器与依赖版本
[导入 Excel 实体类为空](/docs/wujies/5.x/questions/import_excel)EasyExcel 泛型与字段映射
[ParseException SQL 解析异常](/docs/wujies/5.x/questions/parse_exception)多租户 SQL 解析失败

中间件与网关

问题说明
[Only one connection receive subscriber allowed](/docs/wujies/5.x/questions/only_one_subscriber)Redis 响应式连接复用
[为什么删除 sentinel](/docs/wujies/5.x/questions/sentinel_404)Sentinel 移除说明
[如何使用 druid 连接池](/docs/wujies/5.x/questions/use_druid)替换 HikariCP

接口文档与加密

问题说明
[接口文档对接 knife4j](/docs/wujies/5.x/questions/kinfe4j)网关聚合文档
[swagger 相关问题](/docs/wujies/5.x/questions/swagger)注解、分组、鉴权
[前端加密请求](/docs/wujies/5.x/questions/api_encrypt)请求参数加解密与响应解密

项目维护

问题说明
[如何同步项目更新](/docs/wujies/5.x/questions/synchronous_update)上游代码同步策略

平台自有问题

插件安装、应用市场、可视化配置、消息中心、号码认证等平台能力的问题不在官方 FAQ 范围内,统一收录在[平台常见问题](/docs/wujies/5.x/questions/platform-faq)。其中最常见的几类:

  • 插件安装后菜单不显示、路由 404;
  • 插件依赖没有用 provided 导致类冲突;
  • 邮件 / 号码认证保存后不生效;
  • 迁移脚本被判定为「已执行脚本被修改」。

提问前建议附上:版本号、部署方式、完整异常栈、相关配置(隐去密钥),以及复现步骤。

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-6fb6cd07b04e-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容