根本原因是服务端请求体大小限制及前端未启用分片上传：nginx或api网关默认client_max_body_size 10m，且sdk未调用uploadfilebychunk或未配置enablechunkupload: true，导致超限文件触发413错误；excel解压后体积常远超原始大小，需预检结构并提示轻量化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯IMA上传Excel文件超过10MB时提示失败，根本原因不是网络卡顿或账号异常，而是服务端对单次请求体大小做了硬性限制，且前端未启用适配大文件的分片上传机制——直接调用uploadFile方法会把整个文件塞进一次HTTP请求里，一旦解压后内容超10MB，Nginx或API网关立即返回413 Payload Too Large错误。
检查服务端上传限制配置
登录腾讯云控制台 → 进入IMA对应环境的API网关 → 找到该服务的“自定义域名”设置 → 查看或编辑Nginx配置片段（如有）→ 确认是否存在client_max_body_size 10m这一行。
若存在，需将其改为client_max_body_size 50m或更高值，并同步检查后端服务（如Spring Boot）的spring.servlet.multipart.max-request-size是否匹配。不改会导致哪怕前端分片成功，合并阶段仍被网关拦截。
这一步必须由运维或具备控制台权限的开发者操作，普通前端代码无法绕过。
强制启用SDK分片上传
方法一：使用uploadFileByChunk替代uploadFile
原始写法（失败）：IMA.uploadFile({ file: excelFile })
正确写法（成功）：IMA.uploadFileByChunk({ file: excelFile, chunkSize: 5 * 1024 * 1024 }) —— 【chunkSize必须显式指定，不能依赖默认值，否则部分版本SDK会退化为单次上传】
方法二：通过配置全局启用分片
版本定位为桌面办公端，适合 Windows 用户处理本地文件、资料阅读、问答写作和知识库管理。主要特性围绕桌面端文件处理、知识库调用和 AI 工作台操作展开。建议从官网或官网公开下载包获取，不建议使用第三方搬运包。适合生产环境使用。注意事项是当前仅查到 x64 安装包，暂未查到官方公开 ARM Windows 安装包。
初始化IMA SDK时传入{ enableChunkUpload: true }，后续所有uploadFile调用将自动走分片逻辑。但注意：此开关仅在v2.3.0+版本生效，旧版本无效。
预判文件真实体积
第一步：用xlsx库读取Excel文件元数据
在用户点击上传前，先调用XLSX.readFile(file, { cellFormula: false, cellHTML: false, bookSheets: true })解析结构，避开公式、图表、嵌入对象等膨胀源。
第二步：估算解压后体积
读取workbook.SheetNames长度与各sheet的!ref范围，若出现超10万行或含media/目录（图片）、charts/（图表）、drawings/（绘图），说明实际解压体积大概率超20MB。
第三步：触发轻量化提示
当检测到高风险特征时，弹出提示：“该Excel含大量图表/图片，服务器解压后可能超限，建议另存为‘仅数值’格式再上传”。
这一步不做，用户反复上传失败后容易归因为“系统bug”，实则是.xlsx压缩率误导了体积判断。
