如何解决Apache Camel误消费编程创建的S3文件夹问题

Apache Camel AWS S3组件默认仅会跳过携带x-amz-meta-is-folder: true元数据的0字节文件夹占位对象。S3控制台创建文件夹时会自动给占位对象加上该元数据，但AWS CLI、boto3等工具默认创建的以/结尾的0字节占位对象不带该标记，因此会被Camel识别为普通待处理文件，触发消费、转存、删除流程，最终导致目录结构消失。AWS支持提及的“创建逻辑无差异”仅指S3服务端的对象写入逻辑，未覆盖控制台侧自动附加元数据的前端逻辑。

方案1：路由前置过滤（通用无版本依赖，推荐优先使用） #

在S3消费路由的最前端增加过滤规则，直接拦截所有key以/结尾的对象，中断后续处理流程即可，不会触发原有的文件转存、源文件删除逻辑。
注意：过滤逻辑必须放在路由链路的最前端，否则占位对象会先触发S3组件的转存、删除逻辑，过滤不生效。

Java路由写法示例：

from("aws2-s3://源存储桶名?operation=getObject&deleteAfterRead=true&moveAfterRead=true&destinationBucket=目标存储桶名")
    // 拦截S3文件夹占位对象
    .filter(header("CamelAwsS3Key").endsWith("/"))
        .stop()
    .end()
    // 原有业务处理逻辑：生成路径元数据、提交外部系统等
    .to("外部系统端点地址")

XML路由写法示例：

<route>
    <from uri="aws2-s3://源存储桶名?operation=getObject&amp;deleteAfterRead=true&amp;moveAfterRead=true&amp;destinationBucket=目标存储桶名"/>
    <filter>
        <simple>${header.CamelAwsS3Key} ends with '/'</simple>
        <stop/>
    </filter>
    <!-- 原有业务处理逻辑 -->
</route>

方案2：对齐控制台创建文件夹的元数据标记 #

如果不方便调整已上线的Camel路由，可修改自动化创建目录的脚本，给所有以/结尾的0字节占位对象追加和S3控制台一致的is-folder: true元数据，Camel默认规则会直接跳过这类对象，无需调整路由。
AWS CLI创建文件夹示例：

aws s3api put-object --bucket 源存储桶名 --key 目标目录路径/ --content-length 0 --metadata is-folder=true

boto3创建文件夹示例：

import boto3
s3_client = boto3.client('s3')
s3_client.put_object(
    Bucket='源存储桶名',
    Key='目标目录路径/',
    Body=b'',
    Metadata={'is-folder': 'true'}
)

• 禁止开启S3消费端的includeFolders=true配置，该参数会强制将所有文件夹占位对象投递到路由处理链路，直接触发误消费、误删除问题。
• 不建议使用prefix/suffix这类通用文件过滤规则处理该问题，这类规则无法精准匹配文件夹占位对象，容易误伤正常业务文件。
• 若使用Camel 3.x以前版本的旧版aws-s3组件（非aws2-s3），路由中引用的S3对象键头字段名仍为CamelAwsS3Key，无需调整字段名。

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