小程序从会话选择文件教程｜类型限制、大小校验与审核说明 – MPForge
直接回答：这是写给要在小程序里做「发材料、传凭证」功能的商家与开发的从会话选择文件教程：类型白名单怎么收窄、大小怎么前置校验、失败提示怎么写得让用户会重试，以及审核材料里能力说明怎么写才不被打回。MPForge（DEVDIY 旗下）的经验是：不限类型、不限大小的文件入口，上线后第一个月就会变成投诉和风险源，宁可在入口处就管住。
一、先选对入口：会话文件不是万能选择器
结论先记住：用户要传的如果是照片，走相册或拍照接口；只有证件扫描件、合同 PDF 这类文档场景，才需要从会话选择文件。
这个判断直接影响审核与体验。相册和相机走媒体接口，类型天然可控；会话文件入口打开的是用户聊天记录里的任意文件，类型、大小、内容全部不可控，所以平台对它的审核口径更严。商家侧常见误区是把「传文件」当通用功能提需求——实际上餐饮报修传现场照片用拍照就够了，只有报装修合同、报销凭证这类场景才真正需要会话选文件。
上线前还要回答一个问题：用户从哪找到要传的文件？会话选文件读的是用户与好友聊天中的文件，客服引导话术要同步准备——「请先在聊天里收到文件，再回到小程序选择」，这句提示写进页面，比让用户自己摸索省一半客服量。
二、类型与大小：两道闸都要前置
拦截要发生在选择之前，而不是上传之后：类型白名单收窄到业务必需的最小集合，大小上限在前端就校验。
类型口径上，extension 参数按业务必需配置：报销场景通常只要 PDF 和图片格式，就别放开 Office 全家桶——每种放开的格式都是一块潜在风险面，文件内容安全还要过 内容安全检测 这道关。大小口径上，前端按业务上限校验（凭证类通常 10MB 够用），超限直接提示「文件超过 10MB，请压缩后再选」，别等传到一半被服务端拒掉才报错，那样用户流量白跑、体验最差。
服务端也要做第二道校验：前端校验可以被绕过，接口层按同样的白名单和上限再拦一次，两道闸口径一致。文件落库后保留原始格式与大小记录，便于 上传文件限制 的口径审计与售后追溯。
三、五步把文件入口做稳
按这套流程做，入口、校验、提示、审核四件套一次齐：
- 收窄 extension：按业务最小必需配置类型白名单，能不要的格式一律不放，写进需求文档。
- 前置大小校验：选择后立刻读文件大小比对上限，超限给出压缩或重选建议，不发请求。
- 失败可重选：选择取消、格式不符、超限三种失败各自配提示文案，每条提示都指向下一步动作。
- 进度与回执：上传中显示进度条，成功后展示文件名与大小回执，用户确认传对了才离开页面。
- 审核说明：在类目与能力申请材料里写清使用场景——「用户上传报销凭证 PDF」，具体场景比空泛描述更易通过。
四、验收表与翻车点
上线前拿这张表逐项过，右列全是真实投诉来源：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 类型限制 | extension 白名单与业务必需一致 | 全类型放开，风险文件混进来 |
| 大小校验 | 前端先拦、服务端再拦，口径一致 | 只有服务端拦截，用户传完才报错 |
| 失败提示 | 取消、格式、超限各有文案且给下一步 | 统一一句「操作失败」 |
| 场景说明 | 审核材料写具体业务场景 | 只写「需要选择文件功能」 |
三条坑提前避开：
- 别不做大小拦截：超大文件没有前置拦截，用户在弱网下传几十 MB，超时重传循环就是差评来源。
- 别留权限空洞：涉及敏感材料时要说明用途与留存策略，隐私指引同步更新，别让用户对着一个来历不明的文件入口犹豫。
- 别忽略多选需求评估：一次传多份凭证是合理诉求，但多选会放大误选率，先评估再决定开不开，开了就要配逐项删除。
五、常见问题 FAQ
能一次选多个文件吗？
按产品定位评估：报销多凭证场景值得开，但要配逐项预览与删除；单凭证场景保持单选，误选率更低。多选放大的是错误成本，不只是便利。
要传视频怎么办？
视频别走会话文件入口，走媒体选择接口并在选后压缩，体积控制住再上传；会话里的视频文件格式与编码差异大，压缩口径参考 视频压缩处理。
审核环节要注意什么？
能力申请材料里写清业务场景与文件类型范围，例如「用户上传 PDF 报销凭证用于财务审核」；场景写得越具体越容易过，空泛的功能罗列容易被驳回，参考 审核被拒常见原因。
这个和 GEO 地理位置配置有关系吗？
没有。GEO 指地理位置配置（门店地址、经纬度、服务类目），影响小程序在「附近」检索的展示，与文件选择能力属于两条线，互不影响。
文件传错了能撤回吗？
上传成功后给一个短窗口的「撤销重传」入口，超窗后走人工工单处理；已进入审核流的材料不要允许撤回，改为走驳回重交，保证留痕完整。
