Tencent/WeKnora · error

gRPC ReadStream failed: %w

Error message

gRPC ReadStream failed: %w

What it means

Opening the server-streaming ReadStream RPC on the docreader failed in readStream. Callers may inspect the gRPC status: Unimplemented triggers a fallback to unary Read before this error path is taken for other codes.

Source

Thrown at internal/infrastructure/docparser/grpc_parser.go:157

		// the gRPC message-size limit, which is exactly what streaming avoids).
		if status.Code(err) == codes.Unimplemented {
			logger.Warnf(ctx, "docreader ReadStream unimplemented, falling back to unary Read: %v", err)
			return p.readUnary(ctx, client, protoReq)
		}
		return nil, err
	}
	return result, nil
}

// readStream consumes the server-streaming ReadStream RPC: one meta frame
// followed by one frame per image. Errors are returned verbatim so the caller
// can inspect the gRPC status code (e.g. Unimplemented) for fallback.
func (p *GRPCDocumentReader) readStream(
	ctx context.Context, client proto.DocReaderClient, protoReq *proto.ReadRequest,
) (*types.ReadResult, error) {
	stream, err := client.ReadStream(ctx, protoReq)
	if err != nil {
		return nil, fmt.Errorf("gRPC ReadStream failed: %w", err)
	}

	result := &types.ReadResult{}
	gotMeta := false
	for {
		frame, recvErr := stream.Recv()
		if recvErr == io.EOF {
			break
		}
		if recvErr != nil {
			return nil, fmt.Errorf("gRPC ReadStream recv failed: %w", recvErr)
		}

		if meta := frame.GetMeta(); meta != nil {
			gotMeta = true
			result.MarkdownContent = meta.GetMarkdownContent()
			result.ImageDirPath = meta.GetImageDirPath()
			result.Metadata = meta.GetMetadata()

View on GitHub (pinned to 988cbb0330)

Solutions

1. Check docreader server health and logs
2. Inspect the wrapped gRPC status code for the root cause
3. Retry if the status indicates unavailability

When it happens

Trigger: Thrown at internal/infrastructure/docparser/grpc_parser.go:157 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/5019b1da0085968a. Report an issue: GitHub.