常见问题
产品范围、部署运行、初始化登录、数据连接与数据集、报表与大屏使用中的常见问题及解答，均以源码行为为准。
概述
本页按主题列出常见问题。遇到具体报错或异常现象，请直接查看 故障排查，那里按“现象、原因、解决方法”组织。
产品与授权
Q：现在可以使用 Sight BI 赛特智析吗？
A：不可以。当前源码中没有 BI 的后端模块和前端应用，平台只预留了产品标识 bi。自助多维分析、AI 问数、指标中心、数据血缘等都暂未提供。详见 三款产品功能对照表。
Q：Report 里的“仪表盘”是 BI 吗？ A：不是。仪表盘是 Sight Report 的一种文件类型，用区块布局做屏幕上的可交互看板（过滤栏、指标卡、图表、下钻、查看明细，可整页导出 Excel / PDF）。它按设计者预先配置的数据集和区块取数，不提供 BI 那样的自助拖拽分析。创建入口是「系统 > 报表设计 > 新建 > 新建仪表盘」。
Q：未注册时有什么限制？ A：未录入授权时平台按未注册状态运行，报表查看、导出、打印等入口限制访问来源 IP 数：默认在 1 小时的滚动窗口内最多 2 个不同 IP。限制的是来源 IP 数，不是会话数或标签页数，同一 IP 反复访问只占一个名额。超限时提示“当前访问人数已达上限，请稍后再试或联系管理员。”录入授权见「系统 > 注册管理」和 授权与许可。
部署与运行
Q：需要单独安装 JDK 吗？
A：使用程序包（sight-report.jar / sight-wall.jar）直接运行时需要 Java 21 或更高的运行环境，JDK 或 JRE 均可（2.0.61 之前的版本运行期会用到 javac，必须是 JDK）。启动脚本会检查版本，低于 21 直接报错退出。详见 系统要求。
Q：默认端口是多少，怎么修改？
A：Sight Report 为 9091，Sight Wall 为 9090。启动脚本支持通过环境变量 JVM_OPTS 追加 JVM 参数，例如 JVM_OPTS="-Dserver.port=9100" ./start.sh。
Q：日志在哪里？
A：在程序目录的 logs/ 下，Sight Report 为 sight-data-info.log 和 sight-data-error.log，Sight Wall 为 sight-wall-info.log 和 sight-wall-error.log。以系统服务方式运行时，Linux 可用 journalctl -u sight-report -f 跟踪，macOS 看 logs/launchd.out.log 与 logs/launchd.err.log。
Q：怎么升级？
A：日常升级只替换 sight-report.jar（或 sight-wall.jar）这一个文件，其他目录不动，替换前给旧 jar 留一份带时间戳的备份以便回滚。切勿用 rsync --delete、先 rm -rf 再解压、FTP 的“镜像同步”等方式，它们会连同 data/ 里的数据库、授权信息和备份一起删除。
Q：日期显示差了 8 小时？
A：官方启动脚本已固定 -Duser.timezone=Asia/Shanghai。如果你绕过脚本直接用 java -jar 启动，JVM 会使用服务器所在时区，请补上该参数，或改用脚本启动。
Q：内存该怎么配？
A：源码没有规定最低配置。启动脚本不设 JVM_XMX 时，堆上限取可用内存的 75%；生产环境建议显式设置 JVM_XMX=8g 或更高。总内存小于 2GB 时脚本会给出提示。
初始化与登录
Q：可以重复初始化吗？ A：不可以。系统已初始化后再次提交会被拒绝，提示“系统已初始化，请勿重复初始化”。
Q：初始化时忘了勾选“导入演示数据”，还能补导吗？
A：可以。在「系统 > 系统设置 > 示例数据」页点击「重新导入」。该操作只处理随包的示例报表 / 仪表盘和 demo_ 开头的示例表，不影响你自己建的报表、数据连接和业务表。若勾选「强制重建示例数据表」，demo_ 表里的内容会被整个替换。
Q：账号因为输错密码被锁定了怎么办？ A：默认连续输错 5 次锁定 10 分钟，到时自动解除。管理员也可以在「系统 > 系统设置」的「登录解锁」页签中解除。
Q：忘记管理员密码怎么办？ A：系统配置了邮件渠道时，可在登录页「忘记密码？」走邮件自助找回；没有配置时，能登录服务器的管理员可使用应急重置通道，步骤见 首次初始化与登录。
数据连接与数据集
Q：数据库类型旁边写着“（需上传驱动）”是什么意思？
A：该数据库的 JDBC 驱动没有随平台提供。请先在「系统 > 数据连接 > 驱动管理」中「上传驱动」（仅支持 .jar），再新建连接。
Q：保存数据连接时提示“JDBC 连接串包含被禁止的危险参数，已拒绝”？
A：平台会拒绝带有已知高危参数的连接串，包括 MySQL 的 allowLoadLocalInfile、autoDeserialize、socketFactory，以及 H2 的 INIT=、RUNSCRIPT 等。请从 URL 或「扩展参数」中删除这些参数。
Q：API 数据集提示“目标地址被禁止（内网/环回/元数据）”？
A：API 数据集默认只允许访问公网 http / https 地址，并拒绝内网、环回、链路本地（含云元数据地址）等目标，同时不自动跟随重定向。若部署环境完全可信、确实需要调用内网接口，可在启动参数加 -Dsightdata.api-dataset.ssrf-guard.enabled=false，或设置环境变量 SIGHT_DATA_API_SSRF_GUARD=false 关闭该校验。默认开启，关闭前请评估风险。
Q：SQL 数据集末尾能带分号吗？ A：可以带一个结尾分号，引擎会在分页、计数包装之前自动去掉。但语句中间出现分号、或多个分号会被当作多语句而拒绝。
Q：备份恢复后，数据连接都连不上了？
A：备份的文件部分只包含字体、AI 提示词覆盖，以及大屏产品的大屏素材，不包含 data/drivers 与 data/plugins。恢复后连接配置都在，JDBC 驱动 .jar 却不在，需要重新上传驱动，插件也需另行恢复。
报表与大屏
Q：为什么导出或打开公开链接提示“报表尚未发布，无法查看！”？ A：导出和公开链接只对已发布的报表可用。在设计器中点击「发布」后再试。
Q：报表明细不展开，或数据错位？ A：检查数据字段所在单元格的「展开方向」是否为「↓ 向下」或「→向右」，以及父格（「纵向父格(左父格)」「上父格」）是否设置正确，见 父子格与数据绑定。
Q：大屏里配置了「联动本页」但按钮是灰的？ A：「联动本页」需要页面里先有页面变量。在右侧「交互」页签里可以就地新建一个并接上，或在左栏「数据集 > 页面变量」中创建。
Q：大屏模板里的数字是真数据吗？ A：不是。模板自带的是示例数据，上线前要在「数据集」中改成 SQL 或接口数据集并重新绑定。工具栏「自检」里的“数据源接入”会列出仍显示写死数字的组件。
Q：大屏设计器里改了东西，关掉页面就没了？ A：编辑态的改动需要先保存才会进入草稿，直接关闭页面不会自动保存。保存后的草稿可在顶栏「更多 > 草稿记录」中查看，历史发布在「更多 > 版本列表」中查看。
Q：AI 客户端通过 MCP 连上后什么都改不了？ A：令牌不勾选权限时是只读的。需要让 AI 创建或修改草稿，请管理员在「系统 > MCP 接入」中给令牌勾选「写草稿」；「发布」和「平台管理」会直接影响线上内容，非必要不要勾选。
