OnlyOffice 文档加载慢、响应迟滞或样式异常，通常由缓存过期、损坏或膨胀导致；需依次清理前端构建缓存、Docker 运行时缓存、系统级缓存策略、浏览器缓存与 Service Worker，以及云集成场景下的 Office 同步缓存。
如果您使用 OnlyOffice 时发现文档加载缓慢、界面响应迟滞或字体/样式显示异常，则很可能是缓存文件过期、损坏或体积膨胀所致。以下是解决此问题的步骤：
一、清理前端构建缓存
前端构建缓存（如 Webpack 缓存、node_modules、dist 输出目录）若长期未更新，会导致浏览器加载旧版 JS/CSS 资源，引发渲染延迟与功能异常。清理后可强制重新生成最新静态资源。
1、进入 OnlyOffice Docs 项目根目录，执行构建更新脚本：
bash mr-update.sh
2、若脚本不可用，手动清除以下目录：
rm -rf node_modules/ ~/.npm/_cacache/ dist/ build/
3、重新安装依赖并构建：
npm install && npm run build
二、清空 Docker 容器内运行时缓存
Docker 部署的 OnlyOffice 在 /var/tmp、/var/www/cache 等路径会持续写入临时文件与文档渲染缓存，积累过多将显著拖慢首次打开文档的速度。
1、停止运行中的容器：
docker stop onlyoffice
2、进入容器内部执行缓存目录清理：
docker exec -it onlyoffice /bin/bash -c "rm -rf /var/tmp/* /var/www/cache/*"
3、退出容器并重启服务：
docker start onlyoffice
三、重置系统级缓存策略（基于时间与访问频率）
OnlyOffice 默认启用基于 LRU（最近最少使用）和 mtime 的缓存淘汰机制，但若未配置自动清理任务，过期缓存可能长期残留。需主动触发或补全定时策略。
1、手动删除全部缓存文件（保留原始文档数据）：
rm -rf /var/www/cache/*
2、设置每日凌晨 2 点自动清理 7 天前缓存的 cron 任务：
echo "0 2 * * * find /var/www/cache -type f -mtime +7 -delete" | crontab -
构建并调试跨Office自动化流程，实现Word、Excel、PowerPoint之间的内容迁移，使用Open XML、VBA、python-docx、openpyxl、py...
3、验证 cron 是否生效：
crontab -l
四、清除浏览器端缓存与 Service Worker
浏览器缓存了 OnlyOffice 的 JS、CSS、字体及预加载资源，Service Worker 还可能拦截请求并返回陈旧响应，导致界面卡顿或功能错乱。
1、在浏览器地址栏输入：
about:blank，然后按 Ctrl+Shift+Delete（Windows）或 Cmd+Shift+Delete（macOS）
2、勾选“缓存的图像和文件”、“Cookie 及其他网站数据”、“Service Worker”三项
3、时间范围选择“所有时间”，点击“清除数据”
4、关闭全部 OnlyOffice 标签页，重启浏览器后重新访问
五、清理 Office 文档同步缓存（适用于 OnlyOffice 与 OneDrive/Nextcloud 集成场景）
当 OnlyOffice 通过云存储网关（如 DocumentServer + Nextcloud 插件 或 OnlyOffice + OneDrive for Business）访问文档时，本地会生成临时同步缓存，损坏后将阻塞元数据读取与版本比对，造成加载挂起。
1、确认当前用户具有管理员权限，并执行干净启动（禁用所有非 Microsoft 启动项）
2、定位并删除 Office 文档缓存目录：
%localappdata%\Microsoft\Office\16.0\WEF\
3、同步清理云端缓存标记：
在 OneDrive 客户端中右键图标 → “设置” → “账户” → “取消链接此电脑”，再重新登录
