Slack新文件上传接口疑问：length参数及频道上传失败

由于Slack的file.upload接口即将被弃用，我尝试使用新的文件上传方法，操作步骤如下：

1. 调用files.getUploadURLExternal接口 #

请求命令：

curl -s -F files=@test.txt -F filename=test.txt -F token=xoxp-token -F length=50123 https://slack.com/api/files.getUploadURLExternal

返回结果：

{"ok":true,"upload_url":"https://files.slack.com/upload/v1/CwABAAAAXAoAAVnX....","file_id":"F07XXQ9XXXX"}

2. 调用files.completeUploadExternal接口 #

请求命令：

curl -X POST \
  -H "Authorization: Bearer xoxp-token" \
  -H "Content-Type: application/json" \
  -d '{
        "files": [{"id":"F07XXXXXX", "title":"Slack API updates Testing"}],
        "channel_id": "C06EXXXXX"
      }' \
  https://slack.com/api/files.completeUploadExternal

返回结果（200 OK）：

{"ok":true,"files":[{"id":"XXXXXXX","created":XXXXXXXX,"timestamp":XXXXXXXX,"name":"test.txt","title":"Slack API updates Testing","mimetype":"","filetype":"","pretty_type":"","user":"XXXXXXXXX","user_team":"XXXXXXXXX","editable":false,"size":50123,"mode":"hosted","is_external":false,"external_type":"","is_public":false,"public_url_shared":false,"display_as_bot":false,"username":"","url_private":"https://files.slack.com/files-pri/XXXXXXXXX-XXXXXXX/test.txt","url_private_download":"https://files.slack.com/files-pri/XXXXXXXXX-XXXXXXX/download/test.txt","media_display_type":"unknown","permalink":"https://XXXXXXXX.slack.com/files/XXXXXXXXX/XXXXXXX/test.txt","permalink_public":"https://slack-files.com/XXXXXXXXX-XXXXXXX-XXXXXXXX","comments_count":0,"is_starred":false,"shares":{},"channels":[],"groups":[],"ims":[],"has_more_shares":false,"has_rich_preview":false,"file_access":"visible"}],"warning":"missing_charset","response_metadata":{"warnings":["missing_charset"]}}

技术问题及解答 #

1. 如何确定files.getUploadURLExternal请求中的length参数值？

length参数对应要上传文件的字节大小，获取方式如下：

• 命令行方式：
  • Linux/macOS：执行wc -c test.txt，输出的数字即为字节数
  • Windows：执行powershell -Command "(Get-Item test.txt).Length"获取字节数
• 代码方式：
  • Python：import os; os.path.getsize("test.txt")
  • Java：new File("test.txt").length()
  • 其他语言可通过对应文件操作API获取文件的字节长度
    注意：必须保证该值与实际文件的字节数完全一致，否则可能导致上传失败或文件损坏。

2. 已指定channel_id，但文件仍未上传至Slack频道，该如何解决？

结合返回结果中的shares:{}, channels:[]以及missing_charset警告，可从以下方向排查：

• 权限检查：确认使用的用户token（xoxp开头）拥有目标频道的文件上传权限，且已包含files:write的scope权限
• 补充字符集参数：返回提示missing_charset，建议在files.completeUploadExternal的请求体中，给files数组内的对象添加charset字段（如"charset": "utf-8"）
• 验证频道ID正确性：检查channel_id是否完全匹配目标频道的ID，避免拼写错误
• 查询文件状态：调用files.info接口查询该文件的共享状态，确认是否真的未关联到目标频道
• 重试请求：若因网络延迟导致关联失败，可重新调用files.completeUploadExternal接口（需确保使用正确的file_id）

内容的提问来源于stack exchange，提问作者Captain-Robot