> 本文整理自平台文档 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)


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