JeecgBoot低代码平台从 WPS 切换到 OnlyOffice 的开发配置指南

JeecgBoot AI专题研究 | JeecgBoot低代码在线文档编辑器切换与配置实践

JeecgBoot低代码平台同时支持 WPS 和 OnlyOffice 两种在线文档编辑方案。在实际项目中，你可能因为授权成本、部署方式或功能需求等原因，需要从 WPS 切换到 OnlyOffice。

整个切换过程只需要修改前端环境变量和后端配置文件，无需改动任何业务代码。

切换操作集中在环境变量文件中（.env.development 或 .env.production），涉及两项关键配置：

1. 修改文档编辑器版本标识

properties 复制代码

VITE_GLOB_ONLINE_DOCUMENT_VERSION=onlyoffice

将值从 wps 改为 onlyoffice，JeecgBoot低代码前端会自动加载对应的编辑器组件和交互逻辑。

2. 更新代理与域名地址

properties 复制代码

VITE_PROXY=[["/api","http://192.168.1.100:8080/jeecg-boot"]]
VITE_GLOB_DOMAIN_URL=http://192.168.1.100:8080/jeecg-boot

重要提示 ：这里不能使用 localhost 或 127.0.0.1。OnlyOffice 运行在 Docker 容器中，回调请求发起方是容器内部的服务，localhost 指向的是容器自身而非你的开发机。必须使用开发机的实际 IP 地址。

在 JeecgBoot低代码后端的 YAML 配置文件中，需要填写 OnlyOffice 服务的访问地址：

yaml 复制代码

onlyoffice:
  doc-service-url: http://192.168.1.100:9000

确保该地址指向已经部署好的 OnlyOffice DocumentServer 实例。如果尚未部署，请先参考 Docker 安装指南完成 OnlyOffice 的部署。

完成切换后，对照以下清单确认配置正确：

配置项	检查要点
`VITE_GLOB_ONLINE_DOCUMENT_VERSION`	值为 `onlyoffice`
`VITE_PROXY`	IP 地址为实际地址，非 localhost
`VITE_GLOB_DOMAIN_URL`	同上
后端 OnlyOffice 地址	指向正确的 DocumentServer
OnlyOffice 容器	已开启私有 IP 访问权限

编辑器加载失败 ：检查 OnlyOffice 服务是否正常运行，浏览器访问 http://IP:9000 确认。

文档保存失败：大概率是 IP 地址配置问题，确保前后端和 OnlyOffice 三者之间能互相通过 IP 访问。

跨域报错：检查 JeecgBoot低代码前端的代理配置是否正确，以及后端的 CORS 设置。

JeecgBoot低代码平台的文档编辑器切换设计得非常优雅------通过一个环境变量即可完成前端的编辑器切换，配合后端地址配置，整个过程对业务代码零侵入。唯一需要注意的是 IP 地址的配置，务必避免使用 localhost。

本文为 JeecgBoot AI 专题研究系列文章。