Cryptpad电子表格内容消失问题分析与解决方案

问题现象

在Cryptpad 2024.9.0版本中，用户报告了一个严重的问题：当使用"快速"协同编辑模式的电子表格会在一段时间后内容"消失"，表现为空白页面。而使用"严格"协同编辑模式的电子表格则不受影响。服务器重启后问题会暂时解决，但不久后又会重现。

问题特征

1. 特定模式影响：仅影响"快速"协同编辑模式的电子表格
2. 临时解决方案：服务器重启可暂时恢复内容
3. 内存异常：问题出现前服务器内存使用量会异常增加约100MB
4. 浏览器表现：在Firefox中，打开开发者工具后内容会重新显示，关闭后又消失

根本原因分析

经过深入调查，发现问题与跨域资源共享(CORS)配置不当有关：

1. CORS头缺失：反向代理未正确设置Access-Control-Allow-Origin头信息
2. 304响应处理不当：对304(未修改)响应的CORS头处理不正确
3. 沙箱域问题：主域配置了CORS头，但沙箱域缺少必要配置

解决方案

临时解决方案

1. 版本回退：可安全回退到2024.6.0版本，该版本未出现此问题
2. 内存监控：监控服务器内存使用情况，异常时考虑重启

永久解决方案

1. 完善CORS配置：

   • 确保反向代理为所有相关域(包括沙箱域)设置Access-Control-Allow-Origin头
   • 特别处理3xx系列响应(如304)的CORS头

2. 配置示例：

   # 主域和沙箱域的CORS配置
   add_header Access-Control-Allow-Origin *;
   # 其他必要的安全头
   add_header Cross-Origin-Resource-Policy same-origin;
   

部署建议

1. 反向代理配置：确保完整转发所有请求头，不要过滤CORS相关头
2. 资源监控：建立内存使用监控机制，及时发现异常
3. 测试验证：在升级前充分测试电子表格功能，特别是导入和协同编辑

技术背景

Cryptpad的电子表格功能依赖于OnlyOffice组件，该组件对CORS有严格要求。当浏览器无法正确获取CORS头时，会导致内容加载失败。Firefox开发者工具的特殊行为是因为其开发者模式会放宽某些安全限制，从而"意外"解决了CORS问题。

总结

Cryptpad电子表格内容消失问题主要源于CORS配置不当，特别是在复杂部署环境(如使用反向代理)下更易出现。通过完善CORS配置，特别是确保所有子域和各类响应都包含正确的头信息，可以有效解决此问题。对于生产环境，建议在升级前充分测试，并建立完善的监控机制。