absl::Status payload — 구조화된 에러 컨텍스트

1
return absl::FailedPreconditionError(
2
    "rate limit exceeded; retry after 5 seconds; user=alice");

1
auto s = absl::FailedPreconditionError("rate limit exceeded");
2
s.SetPayload(
3
    "type.googleapis.com/google.rpc.RetryInfo",
4
    SerializeRetryInfo({.retry_after = absl::Seconds(5)}));
5
// 호출자는 payload를 꺼내 자동 처리 가능

1
class Status {
2
public:
3
    // payload 설정
4
    void SetPayload(absl::string_view type_url, absl::Cord payload);
5

6
    // payload 조회
7
    absl::optional<absl::Cord> GetPayload(absl::string_view type_url) const;
8

9
    // 모든 payload 순회
10
    void ForEachPayload(
11
        absl::FunctionRef<void(absl::string_view, const absl::Cord&)> visitor
12
    ) const;
13

14
    // payload 제거
15
    bool ErasePayload(absl::string_view type_url);
16
};

1
// 잘 정의된 namespace
2
"type.googleapis.com/google.rpc.RetryInfo"
3
"type.googleapis.com/google.rpc.DebugInfo"
4
"type.googleapis.com/google.rpc.QuotaFailure"
5

6
// 사용자 정의
7
"myorg.example.com/MyError"
8
"github.com/myproject/internal/error_type"

1
message Status {
2
    int32 code = 1;
3
    string message = 2;
4
    repeated google.protobuf.Any details = 3;
5
}

1
// gRPC에서 받은 status를 Abseil status로 변환
2
absl::Status FromGrpcStatus(const grpc::Status& gs) {
3
    absl::Status s(static_cast<absl::StatusCode>(gs.error_code()),
4
                   gs.error_message());
5

6
    // details를 payload로 옮김
7
    google::rpc::Status proto_status;
8
    if (proto_status.ParseFromString(gs.error_details())) {
9
        for (const auto& detail : proto_status.details()) {
10
            s.SetPayload(detail.type_url(), absl::Cord(detail.value()));
11
        }
12
    }
13
    return s;
14
}

1
#include "google/rpc/error_details.pb.h"
2

3
absl::Status MakeRateLimitError() {
4
    auto s = absl::ResourceExhaustedError("rate limit exceeded");
5

6
    google::rpc::RetryInfo retry;
7
    retry.mutable_retry_delay()->set_seconds(5);
8
    s.SetPayload(
9
        "type.googleapis.com/google.rpc.RetryInfo",
10
        absl::Cord(retry.SerializeAsString()));
11

12
    return s;
13
}
14

15
void HandleError(const absl::Status& s) {
16
    auto retry_data = s.GetPayload("type.googleapis.com/google.rpc.RetryInfo");
17
    if (retry_data) {
18
        google::rpc::RetryInfo retry;
19
        retry.ParseFromString(std::string(*retry_data));
20
        absl::Duration delay = absl::Seconds(retry.retry_delay().seconds())
21
                             + absl::Nanoseconds(retry.retry_delay().nanos());
22
        // 자동 재시도 스케줄링
23
        ScheduleRetry(delay);
24
    }
25
}

1
absl::Status ValidateUser(const User& u) {
2
    if (u.name().empty() && u.email().empty()) {
3
        google::rpc::BadRequest bad;
4
        if (u.name().empty()) {
5
            auto* v = bad.add_field_violations();
6
            v->set_field("name");
7
            v->set_description("must not be empty");
8
        }
9
        if (u.email().empty()) {
10
            auto* v = bad.add_field_violations();
11
            v->set_field("email");
12
            v->set_description("must not be empty");
13
        }
14

15
        auto s = absl::InvalidArgumentError("validation failed");
16
        s.SetPayload("type.googleapis.com/google.rpc.BadRequest",
17
                     absl::Cord(bad.SerializeAsString()));
18
        return s;
19
    }
20
    return absl::OkStatus();
21
}

1
// 의사 코드
2
class StatusRep {
3
    StatusCode code;
4
    std::string message;
5

6
    // payload는 보통 없음 — error의 일부 시나리오에서만
7
    std::unique_ptr<absl::flat_hash_map<std::string, absl::Cord>> payloads;
8
};

1
// 회피 — 그냥 string으로 구조화된 정보 인코딩
2
return absl::FailedPreconditionError(
3
    absl::StrCat("retry_after=", 5, "; user=", user));
4

5
// Good — payload 사용
6
auto s = absl::FailedPreconditionError("rate limit");
7
google::rpc::RetryInfo r;
8
r.mutable_retry_delay()->set_seconds(5);
9
s.SetPayload("type.googleapis.com/google.rpc.RetryInfo",
10
             absl::Cord(r.SerializeAsString()));
11
return s;

1
// 회피 — URL 형식 안 지킴
2
s.SetPayload("my_error", payload);
3
// 충돌 위험. 다른 라이브러리도 "my_error"를 쓸 수 있음.
4

5
// Good — namespace 명시
6
s.SetPayload("myorg.example.com/MyError", payload);

1
// 회피 — payload에 raw binary 직접 넣기
2
s.SetPayload("...", absl::Cord(reinterpret_cast<const char*>(&data), sizeof(data)));
3
// portability, versioning, language compatibility 문제.
4

5
// Good — protobuf 또는 다른 명시적 직렬화
6
s.SetPayload("...", absl::Cord(my_message.SerializeAsString()));

1
// 회피 — payload를 너무 자주 사용
2
return absl::NotFoundError("user not found").SetPayload(...);
3
// 단순한 NotFound는 message만으로 충분.
4
// payload는 자동 처리가 필요할 때만.

1
// 회피 — payload type을 caller마다 다르게
2
// Server A: SetPayload("retry_info_v1", ...);
3
// Server B: SetPayload("RetryInfo", ...);
4
// 표준 URL을 모르고 각자 정의.
5

6
// Good — Google 표준 URL 사용
7
"type.googleapis.com/google.rpc.RetryInfo"

1
// 회피 — payload를 message에도 중복 인코딩
2
auto s = absl::InvalidArgumentError(
3
    absl::StrCat("validation failed: field=", field));
4
s.SetPayload("...", SerializeBadRequest({field}));
5
// message는 사람용 요약, payload는 기계용 구조. 분리.
6

7
// Good
8
auto s = absl::InvalidArgumentError("validation failed");
9
s.SetPayload("...", SerializeBadRequest({field}));