Tencent/WeKnora · error

gRPC ReadStream recv failed: %w

Error message

gRPC ReadStream recv failed: %w

What it means

stream.Recv on the docreader ReadStream failed mid-stream in readStream (anything other than io.EOF): the connection dropped or the server errored after sending some frames, so the parse result is incomplete.

Source

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

// 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()
			result.Error = meta.GetError()
			if n := meta.GetImageCount(); n > 0 {
				result.ImageRefs = make([]types.ImageRef, 0, n)
			}
			continue
		}

		if img := frame.GetImage(); img != nil {
			result.ImageRefs = append(result.ImageRefs, types.ImageRef{
				Filename:    img.GetFilename(),
				OriginalRef: img.GetOriginalRef(),

View on GitHub (pinned to 988cbb0330)

Solutions

1. Retry the read; mid-stream drops are often transient
2. Check docreader server logs for the frame that failed
3. Investigate network stability if it recurs on large documents

When it happens

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