{"record":{"id":"488f808c6cb66e00","repo":"Tencent/WeKnora","slug":"failed-to-check-tos-bucket-w","errorCode":null,"errorMessage":"failed to check TOS bucket: %w","messagePattern":"failed to check TOS bucket: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/application/service/file/tos.go","lineNumber":144,"sourceCode":"\tif err == nil {\n\t\treturn nil\n\t}\n\n\tvar serverErr *tos.TosServerError\n\tif errors.As(err, &serverErr) && serverErr.StatusCode == 404 {\n\t\t_, createErr := client.CreateBucketV2(context.Background(), &tos.CreateBucketV2Input{\n\t\t\tBucket: bucketName,\n\t\t})\n\t\tif createErr == nil {\n\t\t\treturn nil\n\t\t}\n\t\tif errors.As(createErr, &serverErr) && serverErr.StatusCode == 409 {\n\t\t\treturn nil\n\t\t}\n\t\treturn fmt.Errorf(\"failed to create TOS bucket: %w\", createErr)\n\t}\n\n\treturn fmt.Errorf(\"failed to check TOS bucket: %w\", err)\n}\n\nfunc joinTOSObjectKey(parts ...string) string {\n\tfiltered := make([]string, 0, len(parts))\n\tfor _, part := range parts {\n\t\tpart = strings.Trim(part, \"/\")\n\t\tif part != \"\" {\n\t\t\tfiltered = append(filtered, part)\n\t\t}\n\t}\n\treturn strings.Join(filtered, \"/\")\n}\n\nfunc parseTOSFilePath(filePath string) (bucketName string, objectKey string, err error) {\n\tif !strings.HasPrefix(filePath, tosScheme) {\n\t\treturn \"\", \"\", fmt.Errorf(\"invalid TOS file path: %s\", filePath)\n\t}\n","sourceCodeStart":126,"sourceCodeEnd":162,"githubUrl":"https://github.com/Tencent/WeKnora/blob/988cbb03305e055d8ebb7d46d9ac6cc0803cd074/internal/application/service/file/tos.go#L126-L162","documentation":"TOS bucket bootstrap: the initial HeadBucket failed with an error other than 404 (auth, network, or throttling), so existence could not be determined and the ensure step fails with the wrapped probe error.","triggerScenarios":"Thrown at internal/application/service/file/tos.go:144 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify TOS endpoint, region, and credentials","Check network egress and throttling limits","Retry the bucket check on transient errors"],"exampleFix":null,"handlingStrategy":"retry","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"}