S3预签名URL在WhatsApp Cloud API无法显示图片问题排查

我需要通过WhatsApp发送存储在S3的图片：AWS控制台生成的预签名URL调用WhatsApp Cloud API后能正常显示图片，但Lambda里用AWS SDK生成的URL虽然API返回200，图片却无法在聊天中显示。两个URL在浏览器中都能正常访问，我用Postman测试消息发送。

控制台生成的URL #

https://MY_BUCKET.s3.us-east-1.amazonaws.com/%2Ftmp/MY_FILE?response-content-disposition=inline&X-Amz-Security-Token=BIG_ENCODED_TOKEN&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240329T204315Z&X-Amz-SignedHeaders=host&X-Amz-Expires=60&X-Amz-Credential=ANOTHER_CREDENTIAL_WITH_MY_REGION&X-Amz-Signature=ANOTHER_SIGNATURE

SDK生成的URL #

https://MY_BUCKET.s3.us-east-1.amazonaws.com//tmp/MY_FILE?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ANOTHER_CREDENTIAL_WITH_MY_REGION&X-Amz-Date=20240329T194855Z&X-Amz-Expires=3600&X-Amz-Security-Token=BIG_ENCODED_TOKEN&X-Amz-Signature=ANOTHER_SIGNATURE&X-Amz-SignedHeaders=host&x-id=GetObject

我的Lambda代码 #

import { S3Client, GetObjectCommand } from '@aws-sdk/client-s3';
import { getSignedUrl } from '@aws-sdk/s3-request-presigner';

const s3Client = new S3Client({ region: 'MY_REGION' });

export const handler = async (event) => {
let params = {
Bucket: 'BUCKET_NAME',
Key: 'OBJECT_KEY',
Expires: 3600
};
try {
const command = new GetObjectCommand(params);
const presignedUrl = await getSignedUrl(s3Client, command, { expiresIn: params.Expires });
return presignedUrl;
} catch (error) {
return error;
}
};

已检查过策略和角色，还需检查哪些内容？如何通过SDK生成与控制台一致的预签名URL以适配WhatsApp Cloud API？

关键差异分析 #

对比两个URL，核心区别在于：

• response-content-disposition=inline 参数：控制台URL包含该参数，SDK生成的没有。WhatsApp可能需要这个响应头确认图片是直接展示而非下载。
• 对象路径格式：控制台URL路径是%2Ftmp/MY_FILE（开头斜杠被编码），SDK生成的是//tmp/MY_FILE（双斜杠），浏览器能兼容，但WhatsApp爬虫可能对路径格式更敏感。
• 额外参数：SDK生成的URL多了X-Amz-Content-Sha256=UNSIGNED-PAYLOAD和x-id=GetObject，虽不影响浏览器访问，但需确保签名参数与控制台对齐。

解决方法 #

修改Lambda代码，添加响应头配置并修正对象Key格式：

import { S3Client, GetObjectCommand } from '@aws-sdk/client-s3';
import { getSignedUrl } from '@aws-sdk/s3-request-presigner';

const s3Client = new S3Client({ region: 'MY_REGION' });

export const handler = async (event) => {
  let params = {
    Bucket: 'BUCKET_NAME',
    Key: '/tmp/MY_FILE', // 匹配控制台的对象Key格式，避免双斜杠
    Expires: 3600,
    ResponseContentDisposition: 'inline' // 添加控制台包含的响应头参数
  };
  try {
    const command = new GetObjectCommand(params);
    const presignedUrl = await getSignedUrl(s3Client, command, { expiresIn: params.Expires });
    return presignedUrl;
  } catch (error) {
    return error;
  }
};

额外检查点 #

• URL编码一致性：确认S3对象的实际Key值，若Key是tmp/MY_FILE（无开头斜杠），需调整代码中的Key参数，避免生成双斜杠路径。
• WhatsApp爬虫访问日志：查看S3访问日志，确认WhatsApp爬虫是否成功获取图片，是否出现4xx/5xx错误。
• 图片Content-Type：若S3对象未正确设置Content-Type，可在GetObjectCommand参数中添加ResponseContentType: 'image/jpeg'（根据图片类型调整），帮助WhatsApp识别文件类型。
• 预签名URL有效期：确保发送消息时URL未过期，控制台设置60秒、SDK设置3600秒均满足需求，无需调整。

内容的提问来源于stack exchange，提问作者Daniel José