Tencent/WeKnora · error

failed to copy file in KS3: %w

Error message

failed to copy file in KS3: %w

What it means

KS3 server-side CopyObject failed while duplicating an object into the knowledge-owned destination key, meaning the new object was not created; credentials, bucket permissions, or source-object availability are the usual causes and the copy is surfaced as failed.

Source

Thrown at internal/application/service/file/ks3.go:209

	srcBucket, srcKey, err := parseKS3FilePath(srcPath)
	if err != nil {
		return "", fmt.Errorf("ks3 copy rejected source %q: %w", srcPath, ErrCrossBackendCopy)
	}
	if err := utils.SafeObjectKey(srcKey); err != nil {
		return "", fmt.Errorf("invalid source path: %w", err)
	}

	ext := filepath.Ext(srcPath)
	destKey := joinKS3Key(s.pathPrefix, fmt.Sprintf("%d", tenantID), knowledgeID, uuid.New().String()+ext)

	_, err = s.client.CopyObject(&ks3s3.CopyObjectInput{
		Bucket:       ks3aws.String(s.bucketName),
		Key:          ks3aws.String(destKey),
		SourceBucket: ks3aws.String(srcBucket),
		SourceKey:    ks3aws.String(srcKey),
	})
	if err != nil {
		return "", fmt.Errorf("failed to copy file in KS3: %w", err)
	}

	newPath := fmt.Sprintf("%s%s/%s", ks3Scheme, s.bucketName, destKey)
	logger.Infof(ctx, "Copied KS3 object %s to %s", srcPath, newPath)
	return newPath, nil
}

func (s *ks3FileService) GetFile(ctx context.Context, filePath string) (io.ReadCloser, error) {
	_, objectKey, err := parseKS3FilePath(filePath)
	if err != nil {
		return nil, err
	}
	if err := utils.SafeObjectKey(objectKey); err != nil {
		return nil, fmt.Errorf("invalid file path: %w", err)
	}

	resp, err := s.client.GetObject(&ks3s3.GetObjectInput{
		Bucket: ks3aws.String(s.bucketName),

View on GitHub (pinned to 988cbb0330)

Solutions

1. Check KS3 credentials and bucket copy permissions
2. Verify the source object still exists
3. Retry the copy on transient S3-compatible errors

When it happens

Trigger: Thrown at internal/application/service/file/ks3.go:209 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Tencent/WeKnora@988cbb0330 (2026-09-02). Data as JSON: /api/errors/1bcbf9c9a6d0d671. Report an issue: GitHub.