上传失败主因是文件不满足硬性条件或环境干扰：文件需≤50MB、仅限PDF/DOCX/XLSX/TXT/MD格式，且须关闭PDF阅读器；推荐Chrome无痕模式上传，并通过TXT测试、Network验证Content-Length与响应码分步定位故障。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
智谱清言智能体上传知识文件失败时，页面常卡在“正在上传…”或直接报错“文件过大”“格式不支持”“系统繁忙”，导致后续所有基于该文件的问答、摘要、表格提取全部无法启动——这不是网络波动的小问题，而是文件未真正进入智能体可调用状态的关键阻断。
确认文件是否满足硬性准入条件
打开系统文件管理器，右键目标文件→选择“属性”，核对两项：文件大小必须≤50MB；扩展名必须是PDF/DOCX/XLSX/TXT/MD中的且仅此一种。ZIP、PPTX、PNG、扫描版PDF（哪怕显示为.pdf）均被后端直接拒绝，连错误提示都不会完整给出。
特别注意：某些PDF由高分辨率扫描生成，Windows属性里显示“4.2MB”，但实际解压文本层后超120MB。这类文件必须先用Adobe Acrobat“另存为”→勾选“优化兼容性”或用Smallpdf在线压缩，否则上传必然静默失败。
【关键前提】上传前务必关闭所有PDF阅读器（尤其是Foxit、WPS PDF、Edge内置PDF查看器），它们会独占文件句柄，导致智谱清言读取失败但页面不报错，只卡在“正在上传…”。
更换浏览器与运行环境
方法一：用Chrome无痕模式访问 https://chat.zhipu.ai → 登录 → 点击输入框旁【+】→“上传文件”→拖入目标文档。这一步跳过全部本地缓存、Cookie污染和扩展干扰，是90%前端上传失败的首选解法。
方法二：若Chrome无痕仍失败，换用Edge浏览器→设置→隐私、搜索和服务→关闭“增强型跟踪防护”→再试一次。部分企业级安全插件（如深信服、网盾）会拦截multipart/form-data请求体，表现为进度条不动、Network中Upload请求状态为空白。
注意：不要用Safari上传XLSX文件，其对Office Open XML格式的MIME类型识别存在固有缺陷，必报“格式错误”，与文件本身无关。
分步验证并定位真实故障点
第一步：上传一个纯TXT文件（内容仅“测试”二字），验证基础通道是否通畅。TXT体积小、解析快、无格式歧义，5秒内返回✅即说明服务端和浏览器链路正常。
第二步：若TXT成功而原文件失败，打开浏览器开发者工具（F12）→ Network标签页→点击Upload接口→检查Headers中Content-Length值是否与文件实际字节数一致。不一致说明中间代理（如公司防火墙、运营商劫持）已截断数据流，必须切换网络环境。
第三步：若Content-Length正确但Response返回413，说明服务器端明确拒绝——此时必须压缩或拆分文件，刷新重传无效，因为413是服务端策略性拦截，非临时抖动。
第四步：若Response为空白且Status显示(canceled)，是浏览器主动终止请求。大概率因HTTPS混合内容触发安全策略（页面为https但某资源加载http），需确认是否通过非官方镜像站（如zhipu-ai.net）访问，必须改用官方域名 https://chat.zhipu.ai。
