常见问题与旧配置处理
排查时先区分问题发生在登录、数据源连接、查询模板、GoView 展示还是项目权限，再处理对应配置。
登录与权限
| 现象 | 处理方法 |
|---|---|
| 主后台已登录，GoView 仍要求登录 | 确认两端使用相同协议、主机和端口，从统一入口重新进入；另一端口或域名不共享登录 |
| 切换账号 后仍显示原用户名或菜单 | 刷新已打开的管理后台页面，再进入 GoView 项目和数据源列表 |
| 提示登录过期 | 重新登录当前系统；若反复出现，记录时间和提示联系管理员 |
| 找不到报表菜单或按钮 | 核对账号角色、菜单和操作权限；授权后刷新页面或重新登录 |
| 项目不在列表、无法预览或编辑 | 核对有效角色是否与项目角色相交，以及查看、编辑等操作权限 |
| 管理员能用，普通用户不能用 | 分别检查普通用户的项目角色、项目操作权限和密文查询执行权限 |
| 切换租户后原查询失败 | 在当前租户重新选择数据源和匹配密文，不复用另一租户的配置 |
详细授权步骤见角色与权限。
数据源与查询
| 现象 | 处理方法 |
|---|---|
| 数据源下拉为空 | 检查当前登录、租户、相关执行或加解密权限，以及数据源是否启用，再点击“刷新” |
| 显示“不可用数据源” | 原源可能停用、删除或不在当前授权范围；先核对源，不直接换成无关数据源 |
| 保存成功但连接失败 | 核对实际主机、端口、协议、库名、账号密码和证书，确认服务可达 |
| TDengine 连接失败 | 核对实际 REST 服务端口，不能直接套用其他协议端口 |
| ES SQL 参数错误 | 确 认模式为 SQL，未误填 DSL 索引；核对 _MAP['字段']、占位符及参数定义 |
| ES DSL 被拒绝 | 核对固定索引和完整值节点；不要使用任意路径、通配符或未支持的脚本 |
| Redis 结果为空 | 核对 DB、已知 Key 和数据类型；不通过 KEYS/SCAN 自动找 Key |
| 动态参数无效 | 检查是否为 name/value 数组、名称唯一、类型匹配、必填值齐全，且未传服务器参数 |
| 提示绑定变化或密文不可执行 | 核对数据源、连接身份、ES 模式及索引，恢复模板后重新生成密文 |
| 加密成功，执行失败 | 加密不访问数据库；回到数据源“查询数据”验证语法、字段和实际值 |
| 只读语句仍被拒绝 | 只支持受控查询范围；多语句、写操作、危险函数、脚本和结构参数不开放 |
| 查询超时或结果超限 | 缩小时间范围、减少字段及返回行数，再由管理员评估资源限制 |
图表与发布
| 现象 | 处理方法 |
|---|---|
| 请求成功，图表没有数据 | 检查是否返回 0 行，以及列名、数值类型、数据映射和过滤配置 |
| 改了前置 URL，报表查询目标没变 | 报表模式固定访问当前站点；换数据库需 改数据源并使用匹配密文 |
| 修改参数后重新打开又恢复旧值 | 查询弹窗保存后，还需点击设计器顶部“保存” |
| 图表没有定时更新 | 核对组件和全局更新间隔及单位；0 表示仅初始化查询 |
| 选择日期后图表不刷新 | 到预览或发布页面操作；检查时间选择器的“选择完成”事件、绑定目标，以及开始/结束参数映射 |
| 新建报表图表不出现在“绑定”目标中 | 确认图表已选“动态请求 → 报表数据查询”；较早版本仍依赖普通 HTTP 地址筛选目标，需更新包含此修正的 GoView 前端 |
| 日期联动参数列表显示“暂无数据” | 先在目标图表或公共数据池的动态参数 JSON 中填写参数名，修正 JSON 错误后再绑定 |
| 选择日期后提示参数类型错误 | 时间戳用 LONG；DATETIME 要求带 T 的字符串，带空格日期时间通常用 STRING；与密文内定义一致才可查询 |
| 自定义格式提示不支持 yyyy | GoView 自定义格式使用 Day.js 标记，年份为 YYYY、月份为 MM、分钟为 mm；不能直接复制后台的 Java 格式 |
| 日期范围少了结束日的数据 | 检查 SQL 的结束边界及所选时刻；控件不会自动加到次日或补成 23:59:59 |
| 清空日期后查询失败 | 清空输出 null；模板若声明必填会拒绝，不会自动改查全部数据 |
| 动态默认日期没有随轮询变化 | 控件默认日期在打开页面和默认规则变化时计算；固定相对范围需要每次刷新重算时使用 SERVER_DATE |
| 升级后旧时间选择器仍传时间戳 | 这是兼容旧设计的默认行为；需要字符串时主动设置输出格式并核对接收参数类型 |
| 找不到“联动输出格式”或“日期时间范围” | 请维护人 员确认当前部署的 GoView 版本包含该功能，更新后刷新页面 |
| 独立预览提示“当前项目暂未发布” | 由编辑人员保存并发布项目；未发布内容从设计器顶部预览 |
| 分享预览地址后仍提示没有权限 | 接收者须登录、具有项目访问角色和相关查看、查询权限 |
完整流程见GoView 设计与发布。
日期筛选的完整配置见日期控件与时间范围筛选。日期控件保留旧输出行为，与下文的旧查询协议迁移是两件事。
处理旧查询配置
旧数据库查询配置和旧密文不会自动转换。看到旧配置警告时按以下步骤处理：
- 先保留可恢复的原项目配置，并记录原查询用途、字段与参数。
- 在主后台确认新数据源可用，调试等价查询，生成新的
RQ2.密文。 - 回到 GoView，在对应控件或公共数据池点击“已备份，重新配置为新查询协议”。
- 重新选择数据源、ES 模式及固定索引，粘贴新密文，配置动态参数。
- 发送请求、检查映射，保存整个项目并预览。
- 对仍使用旧配置的其他控件和公共数据池逐一处理，再使用普通用户核对发布后的访问。
普通 HTTP 请求和静态数据可继续使用，不需要全部改成报表查询。不要在报表模式中粘贴旧明文，也不要借用旧接口绕过配置检查。
反馈问题
联系管理员时提供发生时间、操作入口、数据源类型、项目名称或编号、具体步骤及错误提示。截图只保留定位问题所需内容，移除密码、令牌、有效密文和敏感业务数据。
先说明在哪一步失败，例如“测试连接成功，但明文查询报错”或“查询有结果，但图表为空”，便于快速定位。