Java交互式Slack应用中如何添加PDF文件至消息列表？

问题根源 #

直接给FileBlock传Azure存储的外部URL会触发无效块错误，因为FileBlock仅支持Slack平台托管的文件，必须使用Slack返回的文件ID或内部permalink，不能用第三方存储的链接。

方案1：用本地java.io.File上传后生成FileBlock #

先通过Slack Java SDK的文件上传接口把本地文件传到Slack，拿到文件ID后再构建FileBlock：

// 初始化Slack客户端（需提前配置好API token）
Slack slack = Slack.getInstance();
FilesClient filesClient = slack.files();

// 上传本地PDF文件
UploadV2Response uploadResp = filesClient.uploadV2(req -> req
    .file(new File("你的本地文件路径/file.pdf"))
    .channels(List.of("目标频道ID")) // 可选，也可后续在消息中指定频道
    .title("PDF文件标题")
);

// 提取Slack返回的文件ID
String slackFileId = uploadResp.getFile().getId();

// 构建FileBlock
FileBlock fileBlock = FileBlock.builder()
    .externalId(slackFileId)
    .blockId("自定义块ID")
    .build();

// 将块加入消息列表并发送
List<LayoutBlock> messageBlocks = List.of(fileBlock);
ChatClient chatClient = slack.chat();
chatClient.postMessage(req -> req
    .channel("目标频道ID")
    .blocks(messageBlocks)
);

方案2：从Azure存储获取文件流上传到Slack #

如果不想依赖本地文件，可以直接从Azure Blob存储获取文件输入流，上传到Slack后再生成FileBlock：

// 初始化Azure Blob客户端（需配置连接信息）
BlobClient blobClient = new BlobClientBuilder()
    .connectionString("你的Azure存储连接字符串")
    .containerName("存储容器名")
    .blobName("path/file.pdf")
    .buildClient();

// 获取Azure文件的输入流
InputStream fileStream = blobClient.openInputStream();

// 上传到Slack
UploadV2Response uploadResp = filesClient.uploadV2(req -> req
    .fileData(fileStream)
    .filename("file.pdf")
    .channels(List.of("目标频道ID"))
    .title("来自Azure的PDF文件")
);

// 构建并使用FileBlock，步骤同方案1
String slackFileId = uploadResp.getFile().getId();
FileBlock fileBlock = FileBlock.builder()
    .externalId(slackFileId)
    .blockId("azure-file-block")
    .build();

关键提示 #

不要尝试直接给FileBlock传入外部URL，Slack的Block Kit不支持这种用法。必须先完成文件到Slack平台的上传流程，拿到平台认可的文件标识后，才能通过FileBlock在消息中展示文件。

内容的提问来源于stack exchange，提问作者Matanya Jellinek