Các endpoint REST hiện đại, GraphQL-over-GET và webhook thường xuyên đóng gói mảng nhiều giá trị, đối tượng bộ lọc lồng nhau, con trỏ phân trang Base64 và cụm từ tìm kiếm đã mã hóa URL vào một chuỗi truy vấn duy nhất hoặc phần thân yêu cầu application/x-www-form-urlencoded. Việc kiểm tra hay chỉnh sửa các payload đó dưới dạng chuỗi phẳng thô rất dễ làm hỏng ký tự thoát %26 hoặc lệch dấu ngoặc vuông.
Hãy xem xét một truy vấn tìm kiếm API kết hợp khoảng trắng mã hóa bằng dấu +, các khóa lặp lại, bộ lọc ngoặc vuông lồng nhau, con trỏ phân trang Base64 có phần đệm = được mã hóa phần trăm, và một tham số cờ không có giá trị:
?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run
Phân tích chuỗi này sẽ tạo ra một cấu trúc JSON rõ ràng và dễ đọc ngay lập tức:
{
"q": "distributed tracing",
"tag": [
"otel",
"grpc"
],
"filter": {
"status": "open",
"priority": "high"
},
"cursor": "eyJpZCI6NDIwfQ==",
"dry_run": ""
}
Tại Sao Việc Tách Dấu Phân Cách Phải Diễn Ra Trước Khi Giải Mã Phần Trăm
Hãy chú ý cách cursor=eyJpZCI6NDIwfQ%3D%3D được giải mã gọn gàng thành "eyJpZCI6NDIwfQ==". Bộ phân tích tách chuỗi thô tại dấu & trước tiên, tách mỗi cặp tại dấu = đầu tiên, và chỉ sau đó mới giải mã các chuỗi + và %XX. Nếu một đoạn mã đơn giản chạy decodeURIComponent() trên toàn bộ chuỗi truy vấn trước khi tách theo & và =, bất kỳ giá trị tham số nào chứa dấu và đã được escape (R%26D -> R&D) sẽ bị vỡ thành hai tham số sai lệch.
Vì chế độ xem JSON và bảng key-value luôn đồng bộ hai chiều, bạn cũng có thể dán một đối tượng JSON bộ lọc từ mã nguồn ứng dụng của mình và lập tức tuần tự hóa thành chuỗi truy vấn đã được escape đúng chuẩn để sẵn sàng gửi yêu cầu HTTP.