Go 코드가 대상이다. SQL·스키마는 sqlite-expert/db-expert,\n프론트 산출물 내장의 빌드 순서는 frontend-build 가 맡는다.
이 문서는 일반론을 적지 않는다. 판단이 갈리는 지점, 자주 틀리는 곳, 최근 버전에서\n바뀐 것만 담는다.
\nfmt.Errorf(\"%s 열기 실패: %w\", path, err) — %w 여야\nerrors.Is/errors.As 가 통한다. %v 로 감싸면 사슬이 끊긴다.var ErrNotFound = errors.New(...).\n문자열 비교로 분기하지 않는다.panic 은 프로그래머 오류에만. 입력이 잘못된 것은 에러다.if errors.Is(err, chatdb.ErrNotFound) { ... } // 분기\nvar perr *fs.PathError\nif errors.As(err, &perr) { ... } // 타입 정보가 필요할 때\ngoroutine 을 띄우기 전에 답한다: 누가 이걸 멈추는가? 결과는 누가 받는가?\n답이 없으면 만들지 않는다.
\ncontext.Context 를 첫 인자로 받고,\n종료 신호를 존중한다. 구조체 필드에 context 를 넣지 않는다.sync.WaitGroup 은 Add 를 goroutine 밖에서 부른다. 안에서 부르면 경합이다.-race 로 돌린다. 동시성 코드를 추가·수정했으면 필수다.메서드와 경로 변수를 표준 mux 가 지원한다. 서드파티 라우터를 새로 들이기 전에 이걸로\n충분한지 본다.
\nmux.HandleFunc(\"GET /api/chat/refs/{ref}/rooms\", h)\nmux.HandleFunc(\"DELETE /api/chat/dbs/{db}\", h)\n// 핸들러에서\nref := r.PathValue(\"ref\")\n/api/... 를 등록해두면 / 폴백이 삼키지 않는다.ReadHeaderTimeout 을 준다. 없으면 느린 헤더 공격에 매달린다.mux.HandleFunc(\"GET /api/x\", requireAdmin(cfg, \"X\", handleX))\n//go:embed 는 같은 디렉터리 이하만 가리킨다. ../ 로 못 올라간다.\n상위 폴더의 산출물을 넣으려면 그 폴더 안에 embed 하는 패키지를 둔다..·_ 로 시작하는 파일을 건너뛴다. 포함하려면 all: 접두사.//go:embed all:dist 로 받는다.//go:embed all:dist\nvar dist embed.FS\n\nfunc Built() bool { _, err := fs.Stat(Assets(), \"index.html\"); return err == nil }\nSPA 를 서빙한다면 정적 파일에 없는 경로는 404 가 아니라 index.html 을 돌려줘야\n새로고침·직접 접속이 동작한다.
\nfilepath.Base 로 정규화하고, 남은 값에 구분자가 있으면 거절한다.\n경로 조작은 여기서 끊는다.filepath.EvalSymlinks)\n허용 범위를 검사한다. 링크는 검사 우회의 표준 수법이다.io.LimitReader 로 상한을 두고, 넘으면 지운다. 상한이 없으면 디스크를 채우는\n것만으로 서비스가 멈춘다.got = X, 원하는 값 Y 형태로 무엇이 왜 틀렸는지 드러낸다.t.TempDir()·t.Chdir()·t.Cleanup() 을 쓴다. 수동 정리는 실패 경로에서 새어나간다.httptest.NewServer + 실제 mux 로 인가까지 함께 검증한다.\n핸들러 함수만 직접 부르면 미들웨어가 빠져 \"권한 없이도 되는\" 회귀를 못 잡는다.t.Skip.if got != want {\n t.Errorf(\"%s: 방 수 = %d, 원하는 값 %d\", tc.name, got, want)\n}\nnil 대신 빈 슬라이스로. JSON 에서 null 과 [] 는 다르다.// Search 는 ....gofmt -l 출력 없음, go vet ./... 통과go test ./... 통과 (동시성 변경이 있으면 -race 포함)%w 로 감싸져 있고, 분기 대상은 센티널로 노출됨