Protobuf Wire 디코더

Protobuf Wire 디코더 사용 가이드

gRPC 통신이나 저장된 protobuf 데이터를 디버깅할 때 스키마(.proto)가 없으면 내용을 볼 방법이 막막합니다. protobuf는 '필드 번호 + 자료 형식' 단위로 기록되기 때문에, 이 도구는 스키마 없이도 바이트를 읽어 필드 번호마다 값을 보여 줍니다.

varint 값은 그대로의 정수와 함께 sint32·sint64에서 쓰는 zigzag 해석 값을 나란히 보여 주고, fixed32·fixed64는 정수와 float·double 해석을 함께 표시합니다. 길이가 붙은 값은 올바른 중첩 메시지로 읽히면 들여쓴 { } 블록으로, 사람이 읽을 수 있는 UTF-8이면 문자열로, 그 밖에는 16진수 바이트로 보여 줍니다.

입력은 08 96 01 같은 16진수(0x 접두사·쉼표 허용)나 Base64 모두 됩니다. 바이트가 중간에 끊겼거나 필드 번호가 0이면 몇 번째 바이트에서 문제가 생겼는지 알려 줘 데이터가 잘렸는지, 시작 위치가 틀렸는지 판단할 수 있습니다.

사용 방법

1. 1'Protobuf 바이트' 칸에 16진수 덤프나 Base64 문자열을 붙여 넣습니다.
2. 2'실행'을 누르면 필드 번호: 값 (형식) 줄이 나오고, 중첩 메시지는 들여써서 보입니다.
3. 3가지고 있는 .proto의 필드 번호와 맞춰 보며 값의 의미를 확인합니다.

08 96 01 1a 09 08 01 10 03 2d 00 00 c0 3f 30 05

1: 150 (varint, sint 75)
3 {
  1: 1 (varint, sint -1)
  2: 3 (varint, sint -2)
  5: 1069547520 (fixed32, float 1.5)
}
6: 5 (varint, sint -3)

16바이트 · .proto 없이 해석해 필드 번호만 표시합니다.

이럴 때 쓰면 좋아요

• gRPC 요청·응답 바이트를 개발자 도구에서 복사해 내용을 확인할 때
• 스키마가 사라진 오래된 protobuf 데이터를 분석할 때
• 직접 만든 직렬화 코드가 올바른 바이트를 내는지 검증할 때
• protobuf 인코딩 원리(varint·태그)를 공부할 때

문제가 생겼을 때

활용 팁

• 문자열처럼 보여도 실제로는 bytes나 중첩 메시지일 수 있습니다. 한 글자짜리처럼 애매한 값은 .proto 정의와 비교하세요.
• 음수 int32·int64는 varint 10바이트로 기록되어 큰 양수로 보입니다. 원래 값이 음수라면 sint가 아닌 2의 보수로 해석하세요.

자주 묻는 질문