apache/flink · error · IllegalArgumentException

Bucket name must not be null or empty

Error message

Bucket name must not be null or empty

What it means

Error "Bucket name must not be null or empty" thrown in apache/flink.

Source

Thrown at flink-filesystems/flink-s3-fs-native/src/main/java/org/apache/flink/fs/s3native/S3BucketConfig.java:237

            sb.append(", assumeRoleExternalId='").append(assumeRoleExternalId).append("'");
        }
        if (assumeRoleSessionName != null) {
            sb.append(", assumeRoleSessionName='").append(assumeRoleSessionName).append("'");
        }
        if (assumeRoleSessionDurationSeconds != null) {
            sb.append(", assumeRoleSessionDurationSeconds=")
                    .append(assumeRoleSessionDurationSeconds);
        }
        if (credentialsProvider != null) {
            sb.append(", credentialsProvider='").append(credentialsProvider).append("'");
        }
        sb.append('}');
        return sb.toString();
    }

    static Builder builder(String bucketName) {
        if (StringUtils.isNullOrWhitespaceOnly(bucketName)) {
            throw new IllegalArgumentException("Bucket name must not be null or empty");
        }
        return new Builder(bucketName);
    }

    static final class Builder {
        private final String bucketName;
        @Nullable private String region;
        @Nullable private String endpoint;
        @Nullable private Boolean pathStyleAccess;
        @Nullable private String accessKey;
        @Nullable private String secretKey;
        @Nullable private String sseType;
        @Nullable private String sseKmsKeyId;
        @Nullable private String assumeRoleArn;
        @Nullable private String assumeRoleExternalId;
        @Nullable private String assumeRoleSessionName;
        @Nullable private Integer assumeRoleSessionDurationSeconds;
        @Nullable private String credentialsProvider;

View on GitHub (pinned to 2f3c205e92)

Solutions

1. Address the cause reported by the error message: Bucket name must not be null or empty
2. Verify the inputs, configuration values, and classpath/dependency setup related to this operation, then retry.

Example fix

Correct the condition described ("Bucket name must not be null or empty") and rerun the job or command.

When it happens

Trigger: Triggered at runtime when the operation fails because: Bucket name must not be null or empty.

Common situations: Commonly caused by misconfiguration, missing dependencies or files, unsupported types or operations, or invalid user input leading to: Bucket name must not be null or empty.

AI-assisted analysis of apache/flink@2f3c205e92 (2026-08-14). Data as JSON: /api/errors/37eb8660c94665e9. Report an issue: GitHub.