GoView 大屏设计器

GoView 大屏设计器用于构建可视化看板、大屏展示和运营驾驶舱。RuoYi Office PC 管理端入口位于 apps/web-antd/src/views/report/goview/index.vue，会读取 VITE_GOVIEW_URL 并通过 iframe 打开独立 GoView 前端，同时把 accessToken 与 refreshToken 作为 URL 参数传入。

架构关系

本地启动要点

管理端页面会先探测 VITE_GOVIEW_URL 是否可访问；不可访问时会提示 GoView 服务未启动。默认提示端口为 3000，实际以 .env 中的 VITE_GOVIEW_URL 为准。

powershell

cd W:\ruoyi-office\ruoyi-office-ui-go-view
pnpm install
pnpm dev

后端接口能力

能力	接口	权限	说明
创建项目	`POST /report/go-view/project/create`	`report:go-view-project:create`	保存大屏项目基础信息
更新项目	`PUT /report/go-view/project/update`	`report:go-view-project:update`	更新项目配置
删除项目	`DELETE /report/go-view/project/delete?id=`	`report:go-view-project:delete`	删除大屏项目
我的项目分页	`GET /report/go-view/project/my-page`	`report:go-view-project:query`	按当前登录人查询项目
SQL 数据	`/report/go-view/data/get-by-sql`	`report:go-view-data:get-by-sql`	用 SQL 查询数据
HTTP 数据	`/report/go-view/data/get-by-http`	`report:go-view-data:get-by-http`	示例 HTTP 数据接口

数据接入建议

生产环境慎用自由 SQL：SQL 数据接口应限制数据源和语句范围，避免越权查询和性能风险。
优先封装业务接口：稳定看板建议使用后端业务 API 或聚合接口，不要把复杂逻辑写在大屏组件里。
项目按负责人管理：my-page 按当前登录用户查询项目，适合个人工作台；团队共享可二开项目协作权限。
展示终端单独验证：大屏通常在电视、投屏或大分辨率设备展示，上线前检查缩放、字体和图表自适应。

常见排查

现象	优先检查
页面提示 GoView 服务未启动	`VITE_GOVIEW_URL` 是否正确；GoView 前端服务是否启动；端口是否被防火墙拦截
打开后未登录或接口 401	URL 中 token 是否传入；GoView 前端是否读取 token；后端网关路径是否一致
图表无数据	数据接口权限、SQL、HTTP 参数、跨域配置
保存项目失败	`report:go-view-project:update/create` 权限；项目 JSON 是否过大；后端日志

GoView 大屏设计器 ​

架构关系 ​

本地启动要点 ​

后端接口能力 ​