CodeSampleX

샘플

github.com/go-chi/chi/v5 v5.2.5: Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules

검증된 샘플 — golang github.com/go-chi/chi/v5 v5.2.5: Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules. go 1.26 · linux…

sha256:a88987ec08ebc9ea4e6f2285b0a335a9a6f069729ba80a41094ef71ab2e556f2

이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다. 통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다. MIT-0

실행 증거

선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.

증거 기준
서명된 컨트랙트 통과
검증 영수증
3
빌드한 서명 키
2
선언된 환경 go linux x64 go go go

검증 실행 환경

환경 컨트랙트 단계 실행일
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-17
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18
go 1.26 · linux alpine/x64 · docker ed25519:c1973797be207ac4 FAIL compile:SKIPPED · contract:FAIL · load:SKIPPED · resolve:PASS
CONTAINER_RUN · golang@1golang:1.26-alpine@sha256:28d89ee9cc0f…
2026-09-08

케이스

HOW
목표
Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules
패키지
심벌
  • middleware.RouteHeaders
환경
go
생성일
2026-08-17T01:25:28Z

컨트랙트

  1. `middleware.RouteHeaders().Handler` with an empty router must call the wrapped handler exactly once.
  2. A request through that setup must return exactly one response body write from the downstream handler.

파일

  • NOTES.md
  • csx.json
  • go.mod
  • go.sum
  • route_headers_test.go

소스 아티팩트 내려받기 (tar.gz)

소스

NOTES.md
Known sample cache returned a different chi sample (`sha256:8a05cf61b89bea84e9ae1dc410f9f500c1009e51fec9897152bcdb81c072752f`) focused on URL-param routing, so this project uses a separate `middleware.RouteHeaders` trap.
In pre-fix versions (before `v5.2.5`), `RouteHeaders().Handler` lacked a return on the empty-router branch, so the next handler ran twice on a miss.
csx.json
{"case":{"believed":"If no routes are configured on `middleware.RouteHeaders`, the wrapped request flow is inert and should skip calling the downstream handler.","caseId":"case:sha256:6bd5ff2114c353ba4ae61b235b9ab8aa9349673c1f339286308f766948e5351f","contract":["`middleware.RouteHeaders().Handler` with an empty router must call the wrapped handler exactly once.","A request through that setup must return exactly one response body write from the downstream handler."],"goal":"Avoid duplicate downstream execution when `middleware.RouteHeaders` has no route rules","kind":"HOW","packages":["pkg:golang/github.com/go-chi/chi/v5@v5.2.5"],"schemaVersion":1,"symbols":["middleware.RouteHeaders"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"go","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/go-chi/chi/v5@v5.2.5"],"schemaVersion":1,"symbols":["middleware.RouteHeaders"],"verifierAdapter":"golang@1"}
go.mod
module chi_route_headers

go 1.22

require github.com/go-chi/chi/v5 v5.2.5
go.sum
github.com/go-chi/chi/v5 v5.2.5 h1:Eg4myHZBjyvJmAFjFvWgrqDTXFyOzjj7YIm3L3mu6Ug=
github.com/go-chi/chi/v5 v5.2.5/go.mod h1:X7Gx4mteadT3eDOMTsXzmI4/rwUpOwBHLpAfupzFJP0=
route_headers_test.go
package main

import (
    "net/http"
    "net/http/httptest"
    "testing"

    "github.com/go-chi/chi/v5"
    "github.com/go-chi/chi/v5/middleware"
)

func TestRouteHeadersEmptyRouterCallsNextExactlyOnce(t *testing.T) {
    calls := 0
    r := chi.NewRouter()
    r.Use(middleware.RouteHeaders().Handler)

    r.Get("/", func(w http.ResponseWriter, r *http.Request) {
        calls++
        _, err := w.Write([]byte("ok"))
        if err != nil {
            t.Fatalf("unexpected write error: %v", err)
        }
    })

    req := httptest.NewRequest(http.MethodGet, "/", nil)
    rr := httptest.NewRecorder()

    r.ServeHTTP(rr, req)

    if calls != 1 {
        t.Fatalf("expected downstream handler to run once, got %d", calls)
    }

    if got := rr.Body.String(); got != "ok" {
        t.Fatalf("expected one body write, got %q", got)
    }
}

오리진 시더

csx-seed