{"record":{"id":"80d27d11e0bcb64c","repo":"Tencent/WeKnora","slug":"bucket-q-does-not-exist","errorCode":null,"errorMessage":"bucket %q does not exist","messagePattern":"bucket %q does not exist","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/application/service/file/minio.go","lineNumber":83,"sourceCode":"\t\t}\n\t}\n\n\treturn svc, nil\n}\n\n// CheckConnectivity verifies MinIO is reachable and, if a bucket is configured,\n// that the bucket exists. This is a read-only probe — it never creates a bucket.\nfunc (s *minioFileService) CheckConnectivity(ctx context.Context) error {\n\tcheckCtx, cancel := context.WithTimeout(ctx, 10*time.Second)\n\tdefer cancel()\n\n\tif s.bucketName != \"\" {\n\t\texists, err := s.client.BucketExists(checkCtx, s.bucketName)\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\t\tif !exists {\n\t\t\treturn fmt.Errorf(\"bucket %q does not exist\", s.bucketName)\n\t\t}\n\t\treturn nil\n\t}\n\t_, err := s.client.ListBuckets(checkCtx)\n\treturn err\n}\n\n// CheckMinioConnectivity tests MinIO connectivity using the provided credentials.\n// It creates a temporary service instance internally and delegates to CheckConnectivity.\nfunc CheckMinioConnectivity(ctx context.Context, endpoint, accessKeyID, secretAccessKey, bucketName string, useSSL bool) error {\n\tsvc, err := newMinioClient(endpoint, accessKeyID, secretAccessKey, bucketName, useSSL)\n\tif err != nil {\n\t\treturn err\n\t}\n\treturn svc.CheckConnectivity(ctx)\n}\n\n// parseMinioFilePath extracts the object name from a provider scheme: minio://{bucket}/{objectKey}","sourceCodeStart":65,"sourceCodeEnd":101,"githubUrl":"https://github.com/Tencent/WeKnora/blob/988cbb03305e055d8ebb7d46d9ac6cc0803cd074/internal/application/service/file/minio.go#L65-L101","documentation":"MinIO read-only connectivity probe: BucketExists succeeded but reported the configured bucket absent, so the service is reachable yet misconfigured; the probe never creates buckets, so this is a hard configuration error.","triggerScenarios":"Thrown at internal/application/service/file/minio.go:83 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Create the bucket or correct the bucket name in configuration","Grant the probe credentials and re-run","Distinguish this from connectivity failures when surfacing to users"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"988cbb03305e055d8ebb7d46d9ac6cc0803cd074","analyzedAt":"2026-09-02T14:41:08.344Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}