From efce26611b11723713d328e36149819d18bd63cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Wed, 18 Mar 2026 16:10:35 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[item-management]=20=EA=B0=9C=EB=B0=9C?= =?UTF-8?q?=EC=84=9C=EB=B2=84=20401=20=EC=98=A4=EB=A5=98=20=ED=95=B4?= =?UTF-8?q?=EA=B2=B0=20=EB=82=B4=EC=9A=A9=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changes/20260318_item-management-bom-tree.md | 25 ++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/changes/20260318_item-management-bom-tree.md b/changes/20260318_item-management-bom-tree.md index 67b9822..e022354 100644 --- a/changes/20260318_item-management-bom-tree.md +++ b/changes/20260318_item-management-bom-tree.md @@ -72,6 +72,31 @@ tenant 287(프론트_테스트회사)의 FG 품목 18건에 수식 산출(W:3000 | `POST` | `/api/admin/items/{id}/save-bom` | 수식 산출 결과를 FG BOM으로 저장 | | `GET` | `/api/admin/items/bending-bom-tree` | 절곡 품목 트리 조회 | +### 5. 개발서버 배포 시 401 오류 해결 + +개발서버에서 수식 산출 시 401 인증 오류가 발생했다. 두 가지 원인: + +**원인 1: MNG `.env` API 연결 설정 오류** +- `API_BASE_URL`이 운영 API(`api.codebridge-x.com`)를 가리키고 있었음 +- 개발서버는 자기 자신의 도메인을 DNS로 해석하지 못하므로 `API_INTERNAL_URL=https://127.0.0.1` 설정 추가 +- `API_BASE_URL`은 Host 헤더용, `API_INTERNAL_URL`은 실제 연결용 + +**원인 2: API 미들웨어 화이트리스트 미배포** +- `api/app/Http/Middleware/ApiKeyMiddleware.php`에 `api/v1/quotes/calculate/*` 화이트리스트를 추가한 커밋이 개발서버에 푸시되지 않았음 +- MNG만 푸시하고 API는 누락 → Bearer 토큰 없이 호출 시 401 발생 +- API도 함께 `git push origin develop` 실행하여 해결 + +> **교훈**: MNG에서 API 서버를 호출하는 기능 개발 시, API 프로젝트의 미푸시 커밋도 함께 확인하여 배포해야 한다. + +--- + +## API 엔드포인트 + +| Method | Path | 설명 | +|--------|------|------| +| `POST` | `/api/admin/items/{id}/save-bom` | 수식 산출 결과를 FG BOM으로 저장 | +| `GET` | `/api/admin/items/bending-bom-tree` | 절곡 품목 트리 조회 | + --- ## 관련 문서