AWS Adapter Checksum Algorithm set to NULL for wasabi

[chrisgo]

Bug Report

We were getting an error doing writes to wasabi for large files (16MB seems to be when it switches to multipart) that mentioned checksum Checksum Type mismatch occurred, expected checksum Type: null, actual checksum Type: crc32

There is a workaround but did bring our production systems down for a couple of days since this is also sporadic until we isolated this to "larger" files

This also seems to be working on the Amazon S3 service and ONLY for wasabi (this is the only other S3-compatible provider we have handy)

Q	A
Flysystem Version	^3.10.0
Adapter Name	flysystem-aws-s3-v3
Adapter version	^3.10.0
AWS SDK	^3.295.10

Summary

Tracing this down seems to lead to the ->upload() function being used instead of ->putObject(). The ->upload() function automatically switches to the multipart for large files. The ->putObject() seems to be unaffected

The problem seems to be due to this array https://github.com/thephpleague/flysystem/blob/3.x/src/AwsS3V3/AwsS3V3Adapter.php#L47 where it lists the 'ChecksumAlgorithm' as an AVAILABLE_OPTIONS

Then somewhere when it builds the config, it is setting this to NULL (not sure) https://github.com/thephpleague/flysystem/blob/3.x/src/AwsS3V3/AwsS3V3Adapter.php#L176 instead of taking the default (which seems to be CRC32) and this seems to be what is throwing the error above

How to reproduce

// Provider configuration 
$options = [
  ... // normal stuff per documentation
  'use_path_request_style' => true,  // not really needed for wasabi
];
$client = new \Aws\S3\S3Client($options);
$bucket = 'my-bucket'
$prefix = 'my-prefix';
// Usual way of instantiating the adapter
$adapter = new \League\Flysystem\AwsS3V3\AwsS3V3Adapter($client, $bucket, $prefix);
...

Workaround/Fix

// Provider configuration 
$options = [
  ... // normal stuff per documentation
  'use_path_request_style' => true,  // not really needed for wasabi
];
$client = new \Aws\S3\S3Client($options);
$bucket = 'my-bucket'
$prefix = 'my-prefix';
// 1/31/25 CG: Need to pass the $options (that has the 'ChecksumAlgorithm' = 'CRC32') all the way through to the adapter
$options['ChecksumAlgorithm'] = 'CRC32';
$adapter = new \League\Flysystem\AwsS3V3\AwsS3V3Adapter($client, $bucket, $prefix, null, null, $options);
...