sanitizeOssObjectName

净化 OSS 对象名或路径段，用于 COS key、IM 附件路径、云文档直传文件名等。

函数签名

function sanitizeOssObjectName(raw: string, fallback?: string): string

参数

参数名	类型	必填	说明
raw	string	是	原始名称或路径段
fallback	string	否	净化后为空时使用，默认 file

返回值

类型	说明
string	仅含 [a-zA-Z0-9._-]，最长 200 字符

工作原理

1. 将连续非法字符（非字母数字与 ._-）折叠为单个 _。
2. 截断至 200 字符；空串回退 fallback。

使用场景

• 云文档 cloud-doc/{userId}/{docId}/{fileKey}
• IM 会话头像 im-conv-avatars/{conversationId}.png
• IM 附件 conversations/{id}/{attachmentId}/{fileName}