PSA: AWS S3 SDK compatibility inconsistencies with R2

[hjbugajski]

If you're using @payloadcms/storage-s3 with Cloudflare R2 and receive the following error when trying to access or create uploads, you'll need to pin the @aws-sdk/client-s3 package to version 3.726.1, as newer versions are incompatible with Cloudflare R2.

ERROR: Header 'x-amz-checksum-mode' with value 'ENABLED' not implemented

{
  "pnpm": {
    "overrides": {
      "@aws-sdk/client-s3": "3.726.1"
    }
  },
  "overrides": {
    "@aws-sdk/client-s3": "3.726.1"
  }
}

[akhrarovsaid]

You can do the above, or the alternative is to simply add the following to your plugin config:

plugins: [
  s3Storage({
      // ... Other config like bucket and collections
    config: {
        // ... Other S3 configuration
        requestChecksumCalculation: "WHEN_REQUIRED",
        responseChecksumValidation: "WHEN_REQUIRED",
    },
  }),
]

[hjbugajski]

Nice, I like that a lot more. Thank you!

[xndyz]

Thanks so much for this, was going crazy thinking it was me, anyone know if this is because of a recent change to R2, or the S3 package?

Checked the R2 changelog and they don't mention it 🤔

[hjbugajski]

From Cloudlfare

AWS recently updated their SDKs to enable CRC32 checksums on multiple object operations by default.
R2 does not currently support CRC32 checksums, and the default configurations will return header related errors such as Header 'x-amz-checksum-algorithm' with value 'CRC32' not implemented.