---
kind: CASE
slug: grpc-discovery-f02
title: 리졸버 검증기의 규칙이 하나뿐인데 javadoc 은 복수형으로 서술한다
topic: declaration-and-document-drift
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: case:grpc-discovery-f02
evidenceCapturedOn: 2026-09-01
assets:
  - key: grpc-discovery-f02
    file: ../../../final/evidence/rendered/grpc-discovery-f02.svg
evidence:
  - ../../../final/evidence/raw/grpc-discovery-f02.txt
source:
  - 원본 분석 절은 analysis/grpc/grpc-discovery.md#L177 이다.
module: grpc-discovery
priority: P3
---

# 리졸버 검증기의 규칙이 하나뿐인데 javadoc 은 복수형으로 서술한다

javadoc 은 "Checks a discovery configuration for the things that look right and are not" 라고 적는다. 실제로 담긴 규칙은 균형 정책의 무의미함 하나다.

## 문제

javadoc 은 "Checks a discovery configuration for the things that look right and are not" 라고 적는다.

실제로 담긴 규칙은 균형 정책의 무의미함 하나다.

## 결론

나머지 위험 조합은 GrpcResolverProfile 정규 생성자가 이미 거부하므로 결과적으로 빈틈은 아니다.

다만 목록으로 보고하는 API 형태와 규칙 하나라는 내용이 어긋나 있어, 다음 사람이 여기에 규칙을 더할 자리로 읽거나 이미 여러 규칙이 있다고 읽는다.

§17.1 이 실제로 그 자리다.

## 검증 환경

OpenJDK : 21.0.12   java -version 으로 확인
Gradle : 9.0.0      src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인
확인 방식 : GrpcResolverProfile 참조 16건 검색과 검증기에 실제로 담긴 규칙 수 확인
소스 수정 : x

## 재현 조건

원문은 analysis/grpc/grpc-discovery.md#L177 에 있다.

## 본문

<!-- body:start -->

javadoc 은 "Checks a discovery configuration for **the things** that look right and are not" 라고 적는다. 실제로 담긴 규칙은 균형 정책의 무의미함 하나다.

## GrpcResolverProfile 참조 위치

:::evidence key="grpc-discovery-f02" alt="코드베이스에서 GrpcResolverProfile 를 검색한 출력 16줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="GrpcResolverProfile 코드베이스 검색 — 16줄 · exit 0" zoom="true"
:::

## 결과적으로 빈틈은 아니다

나머지 위험 조합은 `GrpcResolverProfile` 정규 생성자가 이미 거부한다.

## 어긋난 것은 형태와 내용이다

목록으로 보고하는 API 형태와 규칙 하나라는 내용이 어긋나 있어, 다음 사람이 여기에 규칙을 더할 자리로 읽거나 이미 여러 규칙이 있다고 읽는다. §17.1 이 실제로 그 자리다.

## 확인하지 못한 것

시작 검증기를 통한 스킴 거부를 실행으로 확인하지 않았다. 그 검증기가 돌지 않는다.

<!-- body:end -->