AWS S3 ListObjectsV2Command返回null，求助获取指定日期范围CSV文件

一、当前文件夹列表代码的错误修复 #

你的代码返回null的核心原因是调用了类S3Client的send方法，而非你创建的实例s3Client。S3 SDK的send方法需要通过实例调用，而非类本身。

修复后的代码：

import { S3Client, ListObjectsV2Command } from "@aws-sdk/client-s3";
const s3Client = new S3Client({});

export const handler = async(event) => {
    const params = {
        Bucket: 'bucketName',
        Prefix: 'Reports/customerJourney/', // 建议末尾加/，避免匹配到类似Reports/customerJourneyXXX的前缀
        Delimiter: '/',
    }
    
    try{
        // 注意这里是s3Client实例调用send，不是S3Client类
        const data = await s3Client.send(new ListObjectsV2Command(params));
        console.log("Success", data.CommonPrefixes);
        return data.CommonPrefixes;
    } catch (err) {
        console.log("Error", err);
    }
};

说明：

• S3没有真正的“文件夹”，CommonPrefixes返回的是符合Prefix+Delimiter规则的前缀集合，用来模拟文件夹结构
• 前缀末尾加/可以避免误匹配其他相似前缀的对象

二、实现指定日期范围的CSV文件获取 #

针对你获取指定日期范围CSV文件的核心需求，调整代码如下：

1. 移除Delimiter参数，列出所有符合前缀的对象（包括文件）
2. 通过Contents数组中的LastModified字段筛选日期
3. 处理分页：如果文件数量超过1000个，ListObjectsV2会分页返回，需要循环获取所有结果

完整示例代码：

import { S3Client, ListObjectsV2Command } from "@aws-sdk/client-s3";
const s3Client = new S3Client({});

// 指定日期范围（注意S3的LastModified是UTC时间）
const startDate = new Date('2023-01-01T00:00:00Z');
const endDate = new Date('2023-01-07T23:59:59Z');

export const handler = async(event) => {
    let allMatchingFiles = [];
    let continuationToken = null;

    do {
        const params = {
            Bucket: 'bucketName',
            Prefix: 'Reports/customerJourney/',
        };

        // 如果有分页令牌，加入参数
        if (continuationToken) {
            params.ContinuationToken = continuationToken;
        }

        try {
            const data = await s3Client.send(new ListObjectsV2Command(params));
            
            // 筛选符合日期范围且后缀为.csv的文件
            const filtered = data.Contents?.filter(item => {
                const fileDate = item.LastModified;
                // 检查日期范围+文件后缀
                return fileDate >= startDate && fileDate <= endDate && item.Key.endsWith('.csv');
            }) || [];

            allMatchingFiles = [...allMatchingFiles, ...filtered];
            continuationToken = data.NextContinuationToken;

        } catch (err) {
            console.log("Error", err);
            break;
        }
    } while (continuationToken);

    console.log("匹配的CSV文件：", allMatchingFiles);
    return allMatchingFiles;
};

三、排查与探索建议 #

• 权限检查：确保执行代码的IAM角色/用户拥有s3:ListBucket权限，权限策略需包含目标存储桶
• 前缀验证：S3前缀区分大小写，确认Prefix参数和实际存储的路径完全一致（比如是否有大写字母、末尾是否有/）
• 日志调试：在代码中打印完整的data返回值，查看Contents、CommonPrefixes的实际内容，确认是否有数据返回
• 时区处理：S3的LastModified字段是UTC时间，若你的日期范围是本地时间，需要先转换为UTC再比较
• CLI测试：用AWS CLI直接测试列表命令，验证参数是否正确：

  aws s3api list-objects-v2 --bucket bucketName --prefix Reports/customerJourney/
  

• 文件后缀筛选：如果前缀下有非CSV文件，务必通过item.Key.endsWith('.csv')过滤，避免无效文件进入合并流程

内容的提问来源于stack exchange，提问作者Mina Chan