JeecgBoot AI专题研究 | JeecgBoot低代码在线文档编辑器切换与配置实践
切换背景
JeecgBoot低代码平台同时支持 WPS 和 OnlyOffice 两种在线文档编辑方案。在实际项目中，你可能因为授权成本、部署方式或功能需求等原因，需要从 WPS 切换到 OnlyOffice。
整个切换过程只需要修改前端环境变量和后端配置文件，无需改动任何业务代码。
前端配置修改
切换操作集中在环境变量文件中（.env.development 或 .env.production），涉及两项关键配置：
1. 修改文档编辑器版本标识
VITE_GLOB_ONLINE_DOCUMENT_VERSION=onlyoffice
将值从 wps 改为 onlyoffice，JeecgBoot低代码前端会自动加载对应的编辑器组件和交互逻辑。
2. 更新代理与域名地址
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 服务的访问地址：
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 专题研究系列文章。
