File size: 5,507 Bytes
8cdca00 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 | """
gRPC-Web helpers for reverse interfaces.
"""
import base64
import json
import re
import struct
from dataclasses import dataclass
from typing import Dict, List, Mapping, Optional, Tuple
from urllib.parse import unquote
from app.core.logger import logger
# Base64 正则
B64_RE = re.compile(rb"^[A-Za-z0-9+/=\r\n]+$")
@dataclass(frozen=True)
class GrpcStatus:
code: int
message: str = ""
@property
def ok(self) -> bool:
return self.code == 0
@property
def http_equiv(self) -> int:
mapping = {
0: 200,
16: 401,
7: 403,
8: 429,
4: 504,
14: 503,
}
return mapping.get(self.code, 502)
class GrpcClient:
"""gRPC-Web helpers wrapper."""
@staticmethod
def _safe_headers(headers: Optional[Mapping[str, str]]) -> Dict[str, str]:
if not headers:
return {}
safe: Dict[str, str] = {}
for k, v in headers.items():
if k.lower() in ("set-cookie", "cookie", "authorization"):
safe[k] = "<redacted>"
else:
safe[k] = str(v)
return safe
@staticmethod
def _b64(data: bytes) -> str:
return base64.b64encode(data).decode()
@staticmethod
def encode_payload(data: bytes) -> bytes:
"""Encode gRPC-Web data frame."""
return b"\x00" + struct.pack(">I", len(data)) + data
@staticmethod
def _maybe_decode_grpc_web_text(body: bytes, content_type: Optional[str]) -> bytes:
ct = (content_type or "").lower()
if "grpc-web-text" in ct:
compact = b"".join(body.split())
return base64.b64decode(compact, validate=False)
head = body[: min(len(body), 2048)]
if head and B64_RE.fullmatch(head):
compact = b"".join(body.split())
try:
return base64.b64decode(compact, validate=True)
except Exception:
return body
return body
@staticmethod
def _parse_trailer_block(payload: bytes) -> Dict[str, str]:
text = payload.decode("utf-8", errors="replace")
lines = [ln for ln in re.split(r"\r\n|\n", text) if ln]
trailers: Dict[str, str] = {}
for ln in lines:
if ":" not in ln:
continue
k, v = ln.split(":", 1)
trailers[k.strip().lower()] = v.strip()
if "grpc-message" in trailers:
trailers["grpc-message"] = unquote(trailers["grpc-message"])
return trailers
@classmethod
def parse_response(
cls,
body: bytes,
content_type: Optional[str] = None,
headers: Optional[Mapping[str, str]] = None,
) -> Tuple[List[bytes], Dict[str, str]]:
decoded = cls._maybe_decode_grpc_web_text(body, content_type)
messages: List[bytes] = []
trailers: Dict[str, str] = {}
i = 0
n = len(decoded)
while i < n:
if n - i < 5:
break
flag = decoded[i]
length = int.from_bytes(decoded[i + 1 : i + 5], "big")
i += 5
if n - i < length:
break
payload = decoded[i : i + length]
i += length
if flag & 0x80:
trailers.update(cls._parse_trailer_block(payload))
elif flag & 0x01:
raise ValueError("grpc-web compressed flag not supported")
else:
messages.append(payload)
if headers:
lower = {k.lower(): v for k, v in headers.items()}
if "grpc-status" in lower and "grpc-status" not in trailers:
trailers["grpc-status"] = str(lower["grpc-status"]).strip()
if "grpc-message" in lower and "grpc-message" not in trailers:
trailers["grpc-message"] = unquote(str(lower["grpc-message"]).strip())
# Log full response details on gRPC error
raw_status = str(trailers.get("grpc-status", "")).strip()
try:
status_code = int(raw_status)
except Exception:
status_code = -1
if status_code not in (0, -1):
try:
payload = {
"grpc_status": status_code,
"grpc_message": trailers.get("grpc-message", ""),
"content_type": content_type or "",
"headers": cls._safe_headers(headers),
"trailers": trailers,
"messages_b64": [cls._b64(m) for m in messages],
"body_b64": cls._b64(body),
}
logger.error(
"gRPC response error: {}",
json.dumps(payload, ensure_ascii=False),
extra={"error_type": "GrpcError"},
)
except Exception as e:
logger.error(
f"gRPC response error: failed to log payload ({e})",
extra={"error_type": "GrpcError"},
)
return messages, trailers
@staticmethod
def get_status(trailers: Mapping[str, str]) -> GrpcStatus:
raw = str(trailers.get("grpc-status", "")).strip()
msg = str(trailers.get("grpc-message", "")).strip()
try:
code = int(raw)
except Exception:
code = -1
return GrpcStatus(code=code, message=msg)
__all__ = [
"GrpcStatus",
"GrpcClient",
]
|