发布：更新：阅读：199
海外客户从英文产品页下载规格书，文件保存后却叫‘产品说明书 最终版.pdf’。采购转给工程师时，邮件系统把中文和空格编码成一串字符，收件人也看不出文件对应哪个型号。网页上的英文标题没有错，问题出在下载接口仍沿用了后台上传时的原文件名。
一次下载会经过两套名称。服务器用存储名定位文件，浏览器根据响应头决定保存名。页面上的资料标题只负责展示。内容人员若分别维护这几处，换版时很容易只改页面文案，旧名称继续留在接口或 CDN 缓存里。
资料表需要用稳定的产品编码关联文档，不能靠上传文件名猜型号。每条记录应保存文档类型、语言、修订号、适用型号、审核状态和文件地址。英文产品页只读取已审核的英文记录；翻译尚未完成时，页面直接标明可提供的语言，不给中文手册套一个英文名称。
公开文件名可写成‘型号-资料类型-语言-版本’，例如 ak200-datasheet-en-r03.pdf。型号取官网公开型号，版本取受控文件中的修订号。‘final’‘new’或上传日期无法说明审批版本，过几个月后也无法判断哪份有效。客户项目名、内部物料号和报价编号不应进入公开文件名。
手册换版时，新记录先完成审核，再切换当前下载地址。旧文件是否保留，要看已交付产品是否仍需要查阅；需要保留的旧版应写清适用型号和停用日期，不再适用的地址返回明确状态或跳到版本说明页。直接覆盖文件却保留原版本号，会让客户手里的旧附件和官网新内容无法区分。
服务器存储名宜使用 ASCII 字符，减少备份、对象存储和 CDN 处理特殊字符时的差异。下载接口通过 Content-Disposition 给出页面语言对应的保存名，同时保证扩展名与实际 Content-Type 一致。接口若返回登录页或错误页，验收程序要检查状态码和文件头，不能只看最终文件名带有 pdf。
缓存是换版后的高发故障点。页面已经指向 r03，边缘节点仍可能返回 r02，或者文件内容更新了，响应头还保留旧名称。发布记录应同时保存页面 URL、文件地址、修订号和内容校验值。清理缓存后，从不同网络重新下载，比只在后台点开一次更容易发现旧节点。
验收要沿客户的使用路径走一遍。用英文页面在桌面和手机浏览器下载，核对保存名、文档语言、封面型号与修订号；再通过常用邮件客户端转发，确认名称没有乱码或被截断。若资料由表单提交后通过邮件发送，还要检查回执附件，避免网页下载已更新，自动邮件仍挂着旧文件。
后续增加语言、迁移 CDN 或更换资料系统时，抽查同一型号的当前版与一个历史版本。只要页面标题、下载名、文件封面和版本记录有一处对不上，就先暂停该资料入口。修正具体映射或响应配置后再恢复下载，比给所有文件批量改名更稳妥。
