Protobuf JSON 変換・デコード

例：日本語の店舗データ

次の店舗マスタを例にします。

syntax = "proto3";

package shop.v1;

message Store {
  string name = 1;
  string prefecture = 2;
  string postal_code = 3;
  repeated string tags = 4;
}

protoc --encode で作った 54 バイトのデータです。日本語は UTF-8 なので 1 文字 3 バイトになり、「渋」は e6 b8 8b です。

0a 0c e6 b8 8b e8 b0 b7 e6 9c ac e5 ba 97 12 09 e6 9d b1 e4 ba ac e9 83 bd 1a 08 31 35 30 2d 30 30 30 32 22 0f e9 a7 90 e8 bb 8a e5 a0 b4 e3 81 82 e3 82 8a

shop.v1.Store としてデコードすると、こうなります。

{
  "name": "渋谷本店",
  "prefecture": "東京都",
  "postalCode": "150-0002",
  "tags": [
    "駐車場あり"
  ]
}

postal_code が postalCode になるのは、ProtoJSON の仕様でフィールド名を lowerCamelCase に変えるためです。.proto の名前のまま欲しいときは「フィールド名：.proto のまま」を選びます。

例：スキーマがないとき

スキーマ欄を空にして raw 表示を「JSON」にすると、同じバイト列は番号付きで読めます。

{
  "1": "渋谷本店",
  "2": "東京都",
  "3": "150-0002",
  "4": "駐車場あり"
}

長さ付きの値のうち、UTF-8 として読めて制御文字を含まないものは文字列として出します。「protoc —decode_raw」表示に切り替えると protoc --decode_raw と同じ出力になり、日本語は \346\270\213 のような 8 進エスケープになります。protoc は入れ子のメッセージとして読めるものを優先するので、hi のような短い ASCII 文字列が 1 { 13: 105 } と表示されることもあります。

例：JSON からバイナリへ、全角文字の混入

日本語入力のまま JSON を書くと、全角のコロンや空白が紛れ込みがちです。

{"name": "渋谷本店",
 "prefecture"： "東京都"}

「JSON → バイナリ」では、位置を示してエラーにします。

JSON 2 行 14 列：「：」は予期しない文字です。

全角スペース（U+3000）も同じく、その位置でエラーになります。直した JSON を出力「エスケープ文字列」でエンコードすると、Python でそのまま使えるバイト列リテラルになります。

b'\n\x0c\xe6\xb8\x8b\xe8\xb0\xb7\xe6\x9c\xac\xe5\xba\x97\x1a\x08150-0002'

キーは postalCode でも postal_code でも受け付けます。enum は名前でも番号でもよく、int64 は文字列でも数値でも構いません。出力は 16 進・Base64・C の配列も選べ、gRPC フレームを付けたり .bin として保存したりできます。

ほかのツールとの違い

2026-10-02 に、英語版ページの注文データ（Timestamp と 2^53 を超える int64 を含む）で試しました。Bing で「protobuf デコード」の上位に出る serenetia.com の Protobuf Decoder は pawitp の Protobuf Decoder と同じもので、スキーマなしで読み、gRPC のヘッダーも外し、uint・sint・double の読み方を並べて表示しますが、.proto は使えません。codertools.net（日本語版あり）と egohero.com は .proto を使えますが、import "google/protobuf/timestamp.proto" を含むと egohero は「no such Type or Enum ‘google.protobuf.Timestamp’」で止まり、codertools はメッセージ型の一覧が空になります。Timestamp を外すと、どちらも order_id を "9007199254740992"（実際より 1 小さい）と出力し、名前は snake_case のままでした。どのツールも入力をサーバーに送っていませんでした。

制限

• 読み込めるのは .proto のソースだけです。protoc --descriptor_set_out で作ったディスクリプタやテキスト形式のメッセージは読めません。組み込みの import は any・duration・empty・field_mask・struct・timestamp・wrappers で、google/api/annotations.proto などから型を使う場合は追加が必要です。descriptor.proto を拡張するカスタムオプションは無視します。オプションはバイト列に影響しないためです。
• 未知のフィールドは JSON に入りません。 補足に番号・ワイヤタイプ・バイト位置を示し、未知のフィールドなしでデコードできる型も挙げます。
• 型を間違えてもデコードが通ることがあります。 バイト列に型名は入っていないため、補足の未知フィールドの件数を確かめてください。
• 入れ子は 100 段まで、開けるファイルは 2 MB までです。圧縮フレームは gzip だけ展開します。
• proto2 と editions 2023/2024 のグループ、required、closed enum、拡張（"[pkg.ext]"）、フィールドの存在、packed と expanded、delimited に対応します。proto3 の string が UTF-8 として正しくないときは、バイト位置付きのエラーになります。バイナリは bytes に入れてください。

関連ツール：キャプチャは HAR ファイル解析、ペイロードの変換は Base64 エンコード / デコード、JSON の検証は JSON Schema バリデーターで。