附件无法预览的解决步骤：一、启用fileserver.attachment.preview参数；二、确认文件后缀在白名单内；三、检查文件大小未超preview.size.limit与preview.size.limit.max最小值；四、确保云盘服务9400端口连通；五、排查Office转换服务及水印干扰。

如果您在快手网页版中发送或接收私信时，附件无法预览，或创作者消息中的图片加载异常，则可能是由于预览功能未启用、文件类型不支持、大小超限、服务连接失败或水印干扰所致。以下是解决此问题的步骤：

一、检查附件预览功能是否启用

系统需明确开启附件预览开关，否则前端不会渲染预览按钮。该参数控制全局预览能力，关闭状态下所有附件均无预览入口。

1、登录当前环境的 monitor 管理后台，进入注册中心。

2、在服务列表中勾选任意一行，点击【系统属性】。

3、搜索参数名 fileserver.attachment.preview。

4、确认其值为 true；若不存在或为 false，需手动修改并保存。

5、对于6.0及以上版本，该参数已迁移至：公共设置 → 参数配置 → 安全参数 → “启用附件预览参数”，请在此处启用。

二、验证附件文件类型与后缀合法性

快手网页版仅对特定格式的文件提供内嵌预览能力，无后缀、后缀错误或类型不在白名单中，将直接禁用预览逻辑。

1、检查附件是否携带有效后缀，如 .jpg、.pdf、.docx 等。

2、比对支持列表：jpg、jpeg、gif、bmp、png、dib、rle、emf、jpe、pcx、dcx、pic、tga、tif、wmf、jfif、pdf、pptx、ppt、doc、docx、xls、xlsx、txt。

3、若为 .xlsx 或 .docx 类文档，需确认云盘转换服务运行正常（见第四项）。

三、核查附件大小是否超出预览限制

系统通过双重阈值控制可预览文件体积，任一参数限制被触发，即拒绝渲染预览视图，但保留下载功能。

1、在 monitor 注册中心系统属性中，分别查找 preview.size.limit 和 preview.size.limit.max。

2、取二者最小值作为实际生效上限；若最小值为 0，则不限制大小。

3、若参数未配置，preview.size.limit 默认为 0，preview.size.limit.max 默认为 1048576000（即 1GB）。

4、上传前确认附件大小未超过该最小值，否则将显示“无法预览”提示且无按钮。

四、排查云盘服务与苍穹平台连通性

预览依赖云盘服务完成文件拉取、转换与流式响应，若网络链路中断或地址配置错误，将导致空白预览窗口或连接超时。

1、在浏览器中按 F12 打开开发者工具，切换至【网络】标签页。

2、点击附件预览按钮，观察请求目标域名及状态码；若返回 Connect to xxx.xxx.xxx.xxx:9400 failed，表明云盘服务不可达。

3、检查 MC 配置中是否设置了正确的 fileserver 地址，避免默认指向 localhost。

4、确认防火墙、IP 白名单或安全组策略未拦截苍穹服务器到云盘服务器 9400 端口的通信。

五、处理 Office 文档转换失败与水印冲突

Word、Excel 等文档需经云盘内置 Office 转换服务生成 PDF 中间件方可预览；若转换失败或加水印后文件结构损坏，将导致预览中断。

1、确认云盘转换服务进程正在运行，且日志中无 Office conversion timeout 或 failed to load watermark engine 报错。

2、若单据启用了水印功能，请临时关闭水印设置后重试预览。

3、对于提示“文件可能已被损坏，无法进行pdf转换”的情况，需登录云盘部署机，查看 cloud-disk-converter.log 中对应文件ID的转换堆栈。