图片出现裂图
图片裂图通常表示图片地址无法被客户端正确访问。重点排查文件服务、文件访问地址、代理、HTTPS 证书和域名解析。
常见表现
- 聊天图片显示裂图
- 上传成功但无法预览
- PC 正常但移动端裂图
- 历史图片异常而新图片正常
先检查什么
- 图片原文件是否上传成功
- 文件服务是否正常
- 图片地址是否能从客户端访问
- 证书、域名和端口是否一致
处理建议
- 复制图片地址在浏览器测试访问。
- 检查文件服务状态和磁盘空间。
- 确认域名、HTTPS 和代理配置没有变更。
- 如果只影响历史图片，检查旧文件访问地址是否仍有效。
运维侧重点
如果发送文件出现裂图，维护文档建议先检查服务器硬盘空间，再检查或重启 Gofastdfs 文件服务。
重点日志：
text
/usr/local/src/gofastdfs/log/fileserver.log
/usr/local/src/gofastdfs/log/access.log如果 PC 正常、移动端裂图，还需要同步检查域名、HTTPS 证书、代理转发和外网端口是否可达。
什么时候联系管理员或运维
- 影响多人或全员使用时，不建议普通用户自行反复重启或修改配置。
- 涉及生产环境服务重启、证书替换、数据库、文件服务或授权文件时，应由实施或运维人员处理。
- 提交问题时请同时提供故障时间、影响范围、截图、账号、客户端版本和相关日志。