[{"data":1,"prerenderedAt":2337},["ShallowReactive",2],{"blog-post-\u002Fko\u002Fapi-error-response-format":3,"blog-related-source":1988},{"id":4,"title":5,"body":6,"description":1975,"extension":1976,"meta":1977,"navigation":49,"path":1983,"seo":1984,"sitemap":1985,"stem":1986,"__hash__":1987},"ko\u002Fko\u002Fapi-error-response-format.md","API 에러 응답 형식 설계하기: 제각각인 에러 응답을 RFC 9457 Problem Details로 통일하는 법",{"type":7,"value":8,"toc":1966},"minimark",[9,14,18,150,164,185,188,192,294,313,315,319,326,334,408,431,447,449,453,460,630,647,649,653,660,1151,1158,1424,1427,1512,1523,1525,1529,1532,1864,1870,1872,1876,1959,1962],[10,11,13],"h2",{"id":12},"에러마다-모양이-다르다면","에러마다 모양이 다르다면",[15,16,17],"p",{},"한 서비스의 API들이 이런 에러를 돌려준다고 해보자.",[19,20,25],"pre",{"className":21,"code":22,"language":23,"meta":24,"style":24},"language-js shiki shiki-themes github-light github-dark","\u002F\u002F 로그인 API\n\"비밀번호가 틀렸습니다\"\n\n\u002F\u002F 회원가입 API\n{ \"error\": \"이메일 중복\" }\n\n\u002F\u002F 게시글 API\n{ \"success\": false, \"msg\": \"권한 없음\", \"errCode\": 1003 }\n\n\u002F\u002F 결제 API\n{ \"message\": \"Error: Cannot read properties of undefined (reading 'card')\" }\n","js","",[26,27,28,37,44,51,57,76,81,87,124,129,135],"code",{"__ignoreMap":24},[29,30,33],"span",{"class":31,"line":32},"line",1,[29,34,36],{"class":35},"sJ8bj","\u002F\u002F 로그인 API\n",[29,38,40],{"class":31,"line":39},2,[29,41,43],{"class":42},"sZZnC","\"비밀번호가 틀렸습니다\"\n",[29,45,47],{"class":31,"line":46},3,[29,48,50],{"emptyLinePlaceholder":49},true,"\n",[29,52,54],{"class":31,"line":53},4,[29,55,56],{"class":35},"\u002F\u002F 회원가입 API\n",[29,58,60,64,67,70,73],{"class":31,"line":59},5,[29,61,63],{"class":62},"sVt8B","{ ",[29,65,66],{"class":42},"\"error\"",[29,68,69],{"class":62},": ",[29,71,72],{"class":42},"\"이메일 중복\"",[29,74,75],{"class":62}," }\n",[29,77,79],{"class":31,"line":78},6,[29,80,50],{"emptyLinePlaceholder":49},[29,82,84],{"class":31,"line":83},7,[29,85,86],{"class":35},"\u002F\u002F 게시글 API\n",[29,88,90,92,95,97,101,104,107,109,112,114,117,119,122],{"class":31,"line":89},8,[29,91,63],{"class":62},[29,93,94],{"class":42},"\"success\"",[29,96,69],{"class":62},[29,98,100],{"class":99},"sj4cs","false",[29,102,103],{"class":62},", ",[29,105,106],{"class":42},"\"msg\"",[29,108,69],{"class":62},[29,110,111],{"class":42},"\"권한 없음\"",[29,113,103],{"class":62},[29,115,116],{"class":42},"\"errCode\"",[29,118,69],{"class":62},[29,120,121],{"class":99},"1003",[29,123,75],{"class":62},[29,125,127],{"class":31,"line":126},9,[29,128,50],{"emptyLinePlaceholder":49},[29,130,132],{"class":31,"line":131},10,[29,133,134],{"class":35},"\u002F\u002F 결제 API\n",[29,136,138,140,143,145,148],{"class":31,"line":137},11,[29,139,63],{"class":62},[29,141,142],{"class":42},"\"message\"",[29,144,69],{"class":62},[29,146,147],{"class":42},"\"Error: Cannot read properties of undefined (reading 'card')\"",[29,149,75],{"class":62},[15,151,152,153,158,159,163],{},"프론트엔드는 API마다 에러를 꺼내는 코드를 따로 써야 하고, 어떤 에러는 사용자에게 보여줄 수 없는 내부 메시지다. ",[154,155,157],"a",{"href":156},"\u002Fko\u002Fhttp-status-codes-guide","HTTP 상태 코드","로 \"어떤 종류의 실패인지\"를 알렸다면, 이제 ",[160,161,162],"strong",{},"본문","으로 \"무엇이, 왜, 어떻게 실패했는지\"를 일관된 모양으로 알려줄 차례다.",[165,166,167],"blockquote",{},[15,168,169,170,173,174,177,178,181,182],{},"좋은 에러 응답은 ",[160,171,172],{},"모든 API에서 같은 모양","이고, ",[160,175,176],{},"프로그램이 분기할 수 있는 코드","와 ",[160,179,180],{},"사람이 읽을 메시지","를 함께 담고, ",[160,183,184],{},"내부 정보는 담지 않는다.",[186,187],"hr",{},[10,189,191],{"id":190},"좋은-에러-응답의-조건","좋은 에러 응답의 조건",[193,194,195,211],"table",{},[196,197,198],"thead",{},[199,200,201,205,208],"tr",{},[202,203,204],"th",{},"조건",[202,206,207],{},"왜 필요한가",[202,209,210],{},"예시",[212,213,214,229,242,254,267,280],"tbody",{},[199,215,216,220,223],{},[217,218,219],"td",{},"모든 API에서 같은 구조",[217,221,222],{},"프론트엔드가 에러 처리 코드 하나로 모든 API를 다룰 수 있다",[217,224,225,226],{},"항상 ",[26,227,228],{},"{ type, title, status, detail, ... }",[199,230,231,234,237],{},[217,232,233],{},"기계가 읽을 코드",[217,235,236],{},"메시지 문구가 바뀌어도 분기 로직이 깨지지 않는다",[217,238,239],{},[26,240,241],{},"\"code\": \"email_taken\"",[199,243,244,246,249],{},[217,245,180],{},[217,247,248],{},"개발자 디버깅, 그대로 보여줘도 되는 안내",[217,250,251],{},[26,252,253],{},"\"detail\": \"이미 가입된 이메일입니다.\"",[199,255,256,259,262],{},[217,257,258],{},"필드별 에러 목록",[217,260,261],{},"폼에서 어느 입력칸이 틀렸는지 표시할 수 있다",[217,263,264],{},[26,265,266],{},"\"errors\": [{ \"field\": \"email\", ... }]",[199,268,269,272,275],{},[217,270,271],{},"추적 ID",[217,273,274],{},"사용자 문의가 오면 서버 로그에서 바로 찾을 수 있다",[217,276,277],{},[26,278,279],{},"\"traceId\": \"8f2c...\"",[199,281,282,285,288],{},[217,283,284],{},"내부 정보 없음",[217,286,287],{},"스택 트레이스, SQL, 내부 IP는 공격의 단서가 된다",[217,289,290,291],{},"❌ ",[26,292,293],{},"\"Cannot read properties of undefined\"",[295,296,297],"warning",{},[165,298,299],{},[15,300,301,302,305,306,309,310,312],{},"프론트엔드가 ",[160,303,304],{},"메시지 문자열","로 분기하게 만들면 안 된다. ",[26,307,308],{},"if (error.message === \"이미 가입된 이메일입니다\")"," 같은 코드는 문구를 다듬거나 번역하는 순간 깨진다. 분기는 항상 변하지 않는 ",[26,311,26],{},"로 하자.",[186,314],{},[10,316,318],{"id":317},"표준이-있다-rfc-9457-problem-details","표준이 있다: RFC 9457 Problem Details",[15,320,321,322,325],{},"에러 응답 형식을 처음부터 고민할 필요는 없다. HTTP API의 에러 형식을 정한 표준인 ",[160,323,324],{},"RFC 9457 (Problem Details for HTTP APIs)"," 이 있다. 2023년에 이전 버전인 RFC 7807을 대체했다.",[19,327,332],{"className":328,"code":330,"language":331},[329],"language-text","HTTP\u002F1.1 409 Conflict\nContent-Type: application\u002Fproblem+json\n\n{\n  \"type\": \"https:\u002F\u002Fapi.example.com\u002Ferrors\u002Femail_taken\",\n  \"title\": \"이미 사용 중인 이메일입니다\",\n  \"status\": 409,\n  \"detail\": \"taken@example.com은(는) 이미 가입되어 있습니다.\",\n  \"instance\": \"\u002Fusers\"\n}\n","text",[26,333,330],{"__ignoreMap":24},[193,335,336,346],{},[196,337,338],{},[199,339,340,343],{},[202,341,342],{},"필드",[202,344,345],{},"의미",[212,347,348,362,375,385,398],{},[199,349,350,355],{},[217,351,352],{},[26,353,354],{},"type",[217,356,357,358,361],{},"에러 종류를 식별하는 URI. 그 주소에 에러 설명 문서를 두면 좋다 (없으면 ",[26,359,360],{},"\"about:blank\"",")",[199,363,364,369],{},[217,365,366],{},[26,367,368],{},"title",[217,370,371,372,374],{},"에러 종류의 짧은 요약. 같은 ",[26,373,354],{},"이면 항상 같은 문구",[199,376,377,382],{},[217,378,379],{},[26,380,381],{},"status",[217,383,384],{},"HTTP 상태 코드 (응답의 상태 코드와 같게)",[199,386,387,392],{},[217,388,389],{},[26,390,391],{},"detail",[217,393,394,397],{},[160,395,396],{},"이번 발생 건","에 대한 구체적인 설명",[199,399,400,405],{},[217,401,402],{},[26,403,404],{},"instance",[217,406,407],{},"문제가 발생한 요청 경로나 식별자",[15,409,410,413,414,417,418,421,422,103,424,103,427,430],{},[26,411,412],{},"Content-Type","은 ",[26,415,416],{},"application\u002Fproblem+json","을 쓴다. 표준 필드 외에 ",[160,419,420],{},"확장 필드","를 자유롭게 추가할 수 있어서, ",[26,423,26],{},[26,425,426],{},"errors",[26,428,429],{},"traceId"," 같은 필드를 더해도 된다.",[432,433,434],"tip",{},[165,435,436],{},[15,437,438,439,442,443,446],{},"Spring(Java)의 ",[26,440,441],{},"ProblemDetail",", ASP.NET Core의 ",[26,444,445],{},"ProblemDetails","처럼 주요 프레임워크가 이 형식을 기본으로 지원한다. 사내 규칙을 새로 만드는 것보다 표준을 따르면 다른 팀이나 외부 개발자도 바로 이해한다.",[186,448],{},[10,450,452],{"id":451},"검증-에러-필드별로-알려주기","검증 에러: 필드별로 알려주기",[15,454,455,456,459],{},"폼 검증 실패는 여러 필드가 동시에 틀릴 수 있다. 첫 번째 에러 하나만 돌려주면, 사용자는 고치고 제출하고 또 다른 에러를 보는 일을 반복하게 된다. ",[160,457,458],{},"틀린 필드를 한 번에"," 알려주자.",[19,461,465],{"className":462,"code":463,"language":464,"meta":24,"style":24},"language-json shiki shiki-themes github-light github-dark","{\n  \"type\": \"https:\u002F\u002Fapi.example.com\u002Ferrors\u002Fvalidation_failed\",\n  \"title\": \"입력값이 올바르지 않습니다\",\n  \"status\": 422,\n  \"detail\": \"2개 필드를 확인해주세요.\",\n  \"instance\": \"\u002Fusers\",\n  \"code\": \"validation_failed\",\n  \"errors\": [\n    { \"field\": \"email\", \"code\": \"invalid_format\", \"message\": \"이메일 형식이 올바르지 않습니다.\" },\n    { \"field\": \"password\", \"code\": \"too_short\", \"message\": \"비밀번호는 8자 이상이어야 합니다.\" }\n  ]\n}\n","json",[26,466,467,472,485,497,509,521,533,545,553,588,619,624],{"__ignoreMap":24},[29,468,469],{"class":31,"line":32},[29,470,471],{"class":62},"{\n",[29,473,474,477,479,482],{"class":31,"line":39},[29,475,476],{"class":99},"  \"type\"",[29,478,69],{"class":62},[29,480,481],{"class":42},"\"https:\u002F\u002Fapi.example.com\u002Ferrors\u002Fvalidation_failed\"",[29,483,484],{"class":62},",\n",[29,486,487,490,492,495],{"class":31,"line":46},[29,488,489],{"class":99},"  \"title\"",[29,491,69],{"class":62},[29,493,494],{"class":42},"\"입력값이 올바르지 않습니다\"",[29,496,484],{"class":62},[29,498,499,502,504,507],{"class":31,"line":53},[29,500,501],{"class":99},"  \"status\"",[29,503,69],{"class":62},[29,505,506],{"class":99},"422",[29,508,484],{"class":62},[29,510,511,514,516,519],{"class":31,"line":59},[29,512,513],{"class":99},"  \"detail\"",[29,515,69],{"class":62},[29,517,518],{"class":42},"\"2개 필드를 확인해주세요.\"",[29,520,484],{"class":62},[29,522,523,526,528,531],{"class":31,"line":78},[29,524,525],{"class":99},"  \"instance\"",[29,527,69],{"class":62},[29,529,530],{"class":42},"\"\u002Fusers\"",[29,532,484],{"class":62},[29,534,535,538,540,543],{"class":31,"line":83},[29,536,537],{"class":99},"  \"code\"",[29,539,69],{"class":62},[29,541,542],{"class":42},"\"validation_failed\"",[29,544,484],{"class":62},[29,546,547,550],{"class":31,"line":89},[29,548,549],{"class":99},"  \"errors\"",[29,551,552],{"class":62},": [\n",[29,554,555,558,561,563,566,568,571,573,576,578,580,582,585],{"class":31,"line":126},[29,556,557],{"class":62},"    { ",[29,559,560],{"class":99},"\"field\"",[29,562,69],{"class":62},[29,564,565],{"class":42},"\"email\"",[29,567,103],{"class":62},[29,569,570],{"class":99},"\"code\"",[29,572,69],{"class":62},[29,574,575],{"class":42},"\"invalid_format\"",[29,577,103],{"class":62},[29,579,142],{"class":99},[29,581,69],{"class":62},[29,583,584],{"class":42},"\"이메일 형식이 올바르지 않습니다.\"",[29,586,587],{"class":62}," },\n",[29,589,590,592,594,596,599,601,603,605,608,610,612,614,617],{"class":31,"line":131},[29,591,557],{"class":62},[29,593,560],{"class":99},[29,595,69],{"class":62},[29,597,598],{"class":42},"\"password\"",[29,600,103],{"class":62},[29,602,570],{"class":99},[29,604,69],{"class":62},[29,606,607],{"class":42},"\"too_short\"",[29,609,103],{"class":62},[29,611,142],{"class":99},[29,613,69],{"class":62},[29,615,616],{"class":42},"\"비밀번호는 8자 이상이어야 합니다.\"",[29,618,75],{"class":62},[29,620,621],{"class":31,"line":137},[29,622,623],{"class":62},"  ]\n",[29,625,627],{"class":31,"line":626},12,[29,628,629],{"class":62},"}\n",[15,631,632,633,635,636,639,640,642,643,646],{},"프론트엔드는 ",[26,634,426],{},"를 돌면서 각 입력칸 아래에 메시지를 표시하면 된다. 다국어 서비스라면 ",[26,637,638],{},"message"," 대신 ",[26,641,26],{},"(",[26,644,645],{},"too_short",")를 번역 키로 쓰면 된다.",[186,648],{},[10,650,652],{"id":651},"서버에서-한-곳에서-처리하기-nodejs","서버에서 한 곳에서 처리하기 (Node.js)",[15,654,655,656,659],{},"에러 응답을 API마다 직접 만들면 결국 모양이 제각각이 된다. ",[160,657,658],{},"에러 클래스 하나와 에러 응답 함수 하나","를 두고, 모든 에러가 그곳을 거치게 하자.",[19,661,663],{"className":21,"code":662,"language":23,"meta":24,"style":24},"import { randomUUID } from \"node:crypto\";\n\n\u002F\u002F 1. 예상한 에러(클라이언트에게 알려줘도 되는 에러)를 표현하는 클래스\nclass ApiError extends Error {\n  constructor(status, code, title, detail, extra = {}) {\n    super(detail);\n    this.status = status;\n    this.code = code;\n    this.title = title;\n    this.extra = extra;\n  }\n}\n\n\u002F\u002F 2. 모든 에러를 Problem Details 형식으로 바꾸는 한 곳\nfunction sendProblem(req, res, err) {\n  const traceId = randomUUID();\n\n  let body;\n  if (err instanceof ApiError) {\n    body = {\n      type: `https:\u002F\u002Fapi.example.com\u002Ferrors\u002F${err.code}`,\n      title: err.title,\n      status: err.status,\n      detail: err.message,\n      instance: req.url,\n      code: err.code,\n      traceId,\n      ...err.extra,\n    };\n  } else {\n    \u002F\u002F 예상하지 못한 에러: 자세한 내용은 서버 로그에만 남긴다\n    console.error(`[${traceId}]`, err);\n    body = {\n      type: \"about:blank\",\n      title: \"Internal Server Error\",\n      status: 500,\n      detail: \"요청을 처리하는 중 문제가 발생했습니다.\",\n      instance: req.url,\n      traceId,\n    };\n  }\n\n  res.statusCode = body.status;\n  res.setHeader(\"Content-Type\", \"application\u002Fproblem+json\");\n  res.end(JSON.stringify(body));\n}\n",[26,664,665,683,687,692,710,743,751,765,777,789,801,806,810,815,821,848,865,870,879,895,905,926,932,938,944,950,956,962,971,977,988,994,1016,1025,1034,1045,1056,1067,1072,1077,1082,1087,1092,1103,1125,1146],{"__ignoreMap":24},[29,666,667,671,674,677,680],{"class":31,"line":32},[29,668,670],{"class":669},"szBVR","import",[29,672,673],{"class":62}," { randomUUID } ",[29,675,676],{"class":669},"from",[29,678,679],{"class":42}," \"node:crypto\"",[29,681,682],{"class":62},";\n",[29,684,685],{"class":31,"line":39},[29,686,50],{"emptyLinePlaceholder":49},[29,688,689],{"class":31,"line":46},[29,690,691],{"class":35},"\u002F\u002F 1. 예상한 에러(클라이언트에게 알려줘도 되는 에러)를 표현하는 클래스\n",[29,693,694,697,701,704,707],{"class":31,"line":53},[29,695,696],{"class":669},"class",[29,698,700],{"class":699},"sScJk"," ApiError",[29,702,703],{"class":669}," extends",[29,705,706],{"class":699}," Error",[29,708,709],{"class":62}," {\n",[29,711,712,715,717,720,722,724,726,728,730,732,734,737,740],{"class":31,"line":59},[29,713,714],{"class":669},"  constructor",[29,716,642],{"class":62},[29,718,381],{"class":719},"s4XuR",[29,721,103],{"class":62},[29,723,26],{"class":719},[29,725,103],{"class":62},[29,727,368],{"class":719},[29,729,103],{"class":62},[29,731,391],{"class":719},[29,733,103],{"class":62},[29,735,736],{"class":719},"extra",[29,738,739],{"class":669}," =",[29,741,742],{"class":62}," {}) {\n",[29,744,745,748],{"class":31,"line":78},[29,746,747],{"class":99},"    super",[29,749,750],{"class":62},"(detail);\n",[29,752,753,756,759,762],{"class":31,"line":83},[29,754,755],{"class":99},"    this",[29,757,758],{"class":62},".status ",[29,760,761],{"class":669},"=",[29,763,764],{"class":62}," status;\n",[29,766,767,769,772,774],{"class":31,"line":89},[29,768,755],{"class":99},[29,770,771],{"class":62},".code ",[29,773,761],{"class":669},[29,775,776],{"class":62}," code;\n",[29,778,779,781,784,786],{"class":31,"line":126},[29,780,755],{"class":99},[29,782,783],{"class":62},".title ",[29,785,761],{"class":669},[29,787,788],{"class":62}," title;\n",[29,790,791,793,796,798],{"class":31,"line":131},[29,792,755],{"class":99},[29,794,795],{"class":62},".extra ",[29,797,761],{"class":669},[29,799,800],{"class":62}," extra;\n",[29,802,803],{"class":31,"line":137},[29,804,805],{"class":62},"  }\n",[29,807,808],{"class":31,"line":626},[29,809,629],{"class":62},[29,811,813],{"class":31,"line":812},13,[29,814,50],{"emptyLinePlaceholder":49},[29,816,818],{"class":31,"line":817},14,[29,819,820],{"class":35},"\u002F\u002F 2. 모든 에러를 Problem Details 형식으로 바꾸는 한 곳\n",[29,822,824,827,830,832,835,837,840,842,845],{"class":31,"line":823},15,[29,825,826],{"class":669},"function",[29,828,829],{"class":699}," sendProblem",[29,831,642],{"class":62},[29,833,834],{"class":719},"req",[29,836,103],{"class":62},[29,838,839],{"class":719},"res",[29,841,103],{"class":62},[29,843,844],{"class":719},"err",[29,846,847],{"class":62},") {\n",[29,849,851,854,857,859,862],{"class":31,"line":850},16,[29,852,853],{"class":669},"  const",[29,855,856],{"class":99}," traceId",[29,858,739],{"class":669},[29,860,861],{"class":699}," randomUUID",[29,863,864],{"class":62},"();\n",[29,866,868],{"class":31,"line":867},17,[29,869,50],{"emptyLinePlaceholder":49},[29,871,873,876],{"class":31,"line":872},18,[29,874,875],{"class":669},"  let",[29,877,878],{"class":62}," body;\n",[29,880,882,885,888,891,893],{"class":31,"line":881},19,[29,883,884],{"class":669},"  if",[29,886,887],{"class":62}," (err ",[29,889,890],{"class":669},"instanceof",[29,892,700],{"class":699},[29,894,847],{"class":62},[29,896,898,901,903],{"class":31,"line":897},20,[29,899,900],{"class":62},"    body ",[29,902,761],{"class":669},[29,904,709],{"class":62},[29,906,908,911,914,916,919,921,924],{"class":31,"line":907},21,[29,909,910],{"class":62},"      type: ",[29,912,913],{"class":42},"`https:\u002F\u002Fapi.example.com\u002Ferrors\u002F${",[29,915,844],{"class":62},[29,917,918],{"class":42},".",[29,920,26],{"class":62},[29,922,923],{"class":42},"}`",[29,925,484],{"class":62},[29,927,929],{"class":31,"line":928},22,[29,930,931],{"class":62},"      title: err.title,\n",[29,933,935],{"class":31,"line":934},23,[29,936,937],{"class":62},"      status: err.status,\n",[29,939,941],{"class":31,"line":940},24,[29,942,943],{"class":62},"      detail: err.message,\n",[29,945,947],{"class":31,"line":946},25,[29,948,949],{"class":62},"      instance: req.url,\n",[29,951,953],{"class":31,"line":952},26,[29,954,955],{"class":62},"      code: err.code,\n",[29,957,959],{"class":31,"line":958},27,[29,960,961],{"class":62},"      traceId,\n",[29,963,965,968],{"class":31,"line":964},28,[29,966,967],{"class":669},"      ...",[29,969,970],{"class":62},"err.extra,\n",[29,972,974],{"class":31,"line":973},29,[29,975,976],{"class":62},"    };\n",[29,978,980,983,986],{"class":31,"line":979},30,[29,981,982],{"class":62},"  } ",[29,984,985],{"class":669},"else",[29,987,709],{"class":62},[29,989,991],{"class":31,"line":990},31,[29,992,993],{"class":35},"    \u002F\u002F 예상하지 못한 에러: 자세한 내용은 서버 로그에만 남긴다\n",[29,995,997,1000,1003,1005,1008,1010,1013],{"class":31,"line":996},32,[29,998,999],{"class":62},"    console.",[29,1001,1002],{"class":699},"error",[29,1004,642],{"class":62},[29,1006,1007],{"class":42},"`[${",[29,1009,429],{"class":62},[29,1011,1012],{"class":42},"}]`",[29,1014,1015],{"class":62},", err);\n",[29,1017,1019,1021,1023],{"class":31,"line":1018},33,[29,1020,900],{"class":62},[29,1022,761],{"class":669},[29,1024,709],{"class":62},[29,1026,1028,1030,1032],{"class":31,"line":1027},34,[29,1029,910],{"class":62},[29,1031,360],{"class":42},[29,1033,484],{"class":62},[29,1035,1037,1040,1043],{"class":31,"line":1036},35,[29,1038,1039],{"class":62},"      title: ",[29,1041,1042],{"class":42},"\"Internal Server Error\"",[29,1044,484],{"class":62},[29,1046,1048,1051,1054],{"class":31,"line":1047},36,[29,1049,1050],{"class":62},"      status: ",[29,1052,1053],{"class":99},"500",[29,1055,484],{"class":62},[29,1057,1059,1062,1065],{"class":31,"line":1058},37,[29,1060,1061],{"class":62},"      detail: ",[29,1063,1064],{"class":42},"\"요청을 처리하는 중 문제가 발생했습니다.\"",[29,1066,484],{"class":62},[29,1068,1070],{"class":31,"line":1069},38,[29,1071,949],{"class":62},[29,1073,1075],{"class":31,"line":1074},39,[29,1076,961],{"class":62},[29,1078,1080],{"class":31,"line":1079},40,[29,1081,976],{"class":62},[29,1083,1085],{"class":31,"line":1084},41,[29,1086,805],{"class":62},[29,1088,1090],{"class":31,"line":1089},42,[29,1091,50],{"emptyLinePlaceholder":49},[29,1093,1095,1098,1100],{"class":31,"line":1094},43,[29,1096,1097],{"class":62},"  res.statusCode ",[29,1099,761],{"class":669},[29,1101,1102],{"class":62}," body.status;\n",[29,1104,1106,1109,1112,1114,1117,1119,1122],{"class":31,"line":1105},44,[29,1107,1108],{"class":62},"  res.",[29,1110,1111],{"class":699},"setHeader",[29,1113,642],{"class":62},[29,1115,1116],{"class":42},"\"Content-Type\"",[29,1118,103],{"class":62},[29,1120,1121],{"class":42},"\"application\u002Fproblem+json\"",[29,1123,1124],{"class":62},");\n",[29,1126,1128,1130,1133,1135,1138,1140,1143],{"class":31,"line":1127},45,[29,1129,1108],{"class":62},[29,1131,1132],{"class":699},"end",[29,1134,642],{"class":62},[29,1136,1137],{"class":99},"JSON",[29,1139,918],{"class":62},[29,1141,1142],{"class":699},"stringify",[29,1144,1145],{"class":62},"(body));\n",[29,1147,1149],{"class":31,"line":1148},46,[29,1150,629],{"class":62},[15,1152,1153,1154,1157],{},"비즈니스 로직에서는 상황에 맞는 ",[26,1155,1156],{},"ApiError","를 던지기만 하면 된다.",[19,1159,1161],{"className":21,"code":1160,"language":23,"meta":24,"style":24},"async function createUser(input) {\n  const errors = [];\n  if (!isEmail(input.email)) {\n    errors.push({ field: \"email\", code: \"invalid_format\", message: \"이메일 형식이 올바르지 않습니다.\" });\n  }\n  if ((input.password ?? \"\").length \u003C 8) {\n    errors.push({ field: \"password\", code: \"too_short\", message: \"비밀번호는 8자 이상이어야 합니다.\" });\n  }\n  if (errors.length > 0) {\n    throw new ApiError(422, \"validation_failed\", \"입력값이 올바르지 않습니다\",\n      `${errors.length}개 필드를 확인해주세요.`, { errors });\n  }\n\n  if (await emailExists(input.email)) {\n    throw new ApiError(409, \"email_taken\", \"이미 사용 중인 이메일입니다\",\n      `${input.email}은(는) 이미 가입되어 있습니다.`);\n  }\n  \u002F\u002F ...\n}\n",[26,1162,1163,1181,1193,1209,1235,1239,1266,1286,1290,1307,1331,1348,1352,1356,1370,1395,1411,1415,1420],{"__ignoreMap":24},[29,1164,1165,1168,1171,1174,1176,1179],{"class":31,"line":32},[29,1166,1167],{"class":669},"async",[29,1169,1170],{"class":669}," function",[29,1172,1173],{"class":699}," createUser",[29,1175,642],{"class":62},[29,1177,1178],{"class":719},"input",[29,1180,847],{"class":62},[29,1182,1183,1185,1188,1190],{"class":31,"line":39},[29,1184,853],{"class":669},[29,1186,1187],{"class":99}," errors",[29,1189,739],{"class":669},[29,1191,1192],{"class":62}," [];\n",[29,1194,1195,1197,1200,1203,1206],{"class":31,"line":46},[29,1196,884],{"class":669},[29,1198,1199],{"class":62}," (",[29,1201,1202],{"class":669},"!",[29,1204,1205],{"class":699},"isEmail",[29,1207,1208],{"class":62},"(input.email)) {\n",[29,1210,1211,1214,1217,1220,1222,1225,1227,1230,1232],{"class":31,"line":53},[29,1212,1213],{"class":62},"    errors.",[29,1215,1216],{"class":699},"push",[29,1218,1219],{"class":62},"({ field: ",[29,1221,565],{"class":42},[29,1223,1224],{"class":62},", code: ",[29,1226,575],{"class":42},[29,1228,1229],{"class":62},", message: ",[29,1231,584],{"class":42},[29,1233,1234],{"class":62}," });\n",[29,1236,1237],{"class":31,"line":59},[29,1238,805],{"class":62},[29,1240,1241,1243,1246,1249,1252,1255,1258,1261,1264],{"class":31,"line":78},[29,1242,884],{"class":669},[29,1244,1245],{"class":62}," ((input.password ",[29,1247,1248],{"class":669},"??",[29,1250,1251],{"class":42}," \"\"",[29,1253,1254],{"class":62},").",[29,1256,1257],{"class":99},"length",[29,1259,1260],{"class":669}," \u003C",[29,1262,1263],{"class":99}," 8",[29,1265,847],{"class":62},[29,1267,1268,1270,1272,1274,1276,1278,1280,1282,1284],{"class":31,"line":83},[29,1269,1213],{"class":62},[29,1271,1216],{"class":699},[29,1273,1219],{"class":62},[29,1275,598],{"class":42},[29,1277,1224],{"class":62},[29,1279,607],{"class":42},[29,1281,1229],{"class":62},[29,1283,616],{"class":42},[29,1285,1234],{"class":62},[29,1287,1288],{"class":31,"line":89},[29,1289,805],{"class":62},[29,1291,1292,1294,1297,1299,1302,1305],{"class":31,"line":126},[29,1293,884],{"class":669},[29,1295,1296],{"class":62}," (errors.",[29,1298,1257],{"class":99},[29,1300,1301],{"class":669}," >",[29,1303,1304],{"class":99}," 0",[29,1306,847],{"class":62},[29,1308,1309,1312,1315,1317,1319,1321,1323,1325,1327,1329],{"class":31,"line":131},[29,1310,1311],{"class":669},"    throw",[29,1313,1314],{"class":669}," new",[29,1316,700],{"class":699},[29,1318,642],{"class":62},[29,1320,506],{"class":99},[29,1322,103],{"class":62},[29,1324,542],{"class":42},[29,1326,103],{"class":62},[29,1328,494],{"class":42},[29,1330,484],{"class":62},[29,1332,1333,1336,1338,1340,1342,1345],{"class":31,"line":137},[29,1334,1335],{"class":42},"      `${",[29,1337,426],{"class":62},[29,1339,918],{"class":42},[29,1341,1257],{"class":99},[29,1343,1344],{"class":42},"}개 필드를 확인해주세요.`",[29,1346,1347],{"class":62},", { errors });\n",[29,1349,1350],{"class":31,"line":626},[29,1351,805],{"class":62},[29,1353,1354],{"class":31,"line":812},[29,1355,50],{"emptyLinePlaceholder":49},[29,1357,1358,1360,1362,1365,1368],{"class":31,"line":817},[29,1359,884],{"class":669},[29,1361,1199],{"class":62},[29,1363,1364],{"class":669},"await",[29,1366,1367],{"class":699}," emailExists",[29,1369,1208],{"class":62},[29,1371,1372,1374,1376,1378,1380,1383,1385,1388,1390,1393],{"class":31,"line":823},[29,1373,1311],{"class":669},[29,1375,1314],{"class":669},[29,1377,700],{"class":699},[29,1379,642],{"class":62},[29,1381,1382],{"class":99},"409",[29,1384,103],{"class":62},[29,1386,1387],{"class":42},"\"email_taken\"",[29,1389,103],{"class":62},[29,1391,1392],{"class":42},"\"이미 사용 중인 이메일입니다\"",[29,1394,484],{"class":62},[29,1396,1397,1399,1401,1403,1406,1409],{"class":31,"line":850},[29,1398,1335],{"class":42},[29,1400,1178],{"class":62},[29,1402,918],{"class":42},[29,1404,1405],{"class":62},"email",[29,1407,1408],{"class":42},"}은(는) 이미 가입되어 있습니다.`",[29,1410,1124],{"class":62},[29,1412,1413],{"class":31,"line":867},[29,1414,805],{"class":62},[29,1416,1417],{"class":31,"line":872},[29,1418,1419],{"class":35},"  \u002F\u002F ...\n",[29,1421,1422],{"class":31,"line":881},[29,1423,629],{"class":62},[15,1425,1426],{},"이 구조로 실제 요청을 보내보면 이렇게 응답한다.",[193,1428,1429,1439],{},[196,1430,1431],{},[199,1432,1433,1436],{},[202,1434,1435],{},"요청",[202,1437,1438],{},"응답",[212,1440,1441,1460,1472,1485,1498],{},[199,1442,1443,1453],{},[217,1444,1445,1446,1449,1450],{},"이메일 ",[26,1447,1448],{},"kim",", 비밀번호 ",[26,1451,1452],{},"123",[217,1454,1455,103,1457,1459],{},[26,1456,506],{},[26,1458,426],{},"에 두 필드",[199,1461,1462,1465],{},[217,1463,1464],{},"이미 가입된 이메일",[217,1466,1467,103,1469],{},[26,1468,1382],{},[26,1470,1471],{},"code: \"email_taken\"",[199,1473,1474,1477],{},[217,1475,1476],{},"깨진 JSON",[217,1478,1479,103,1482],{},[26,1480,1481],{},"400",[26,1483,1484],{},"code: \"invalid_json\"",[199,1486,1487,1490],{},[217,1488,1489],{},"DB 연결 실패 같은 예상 못 한 에러",[217,1491,1492,1494,1495,1497],{},[26,1493,1053],{},", 일반 안내 + ",[26,1496,429],{}," (DB 주소는 서버 로그에만)",[199,1499,1500,1503],{},[217,1501,1502],{},"정상 요청",[217,1504,1505,1508,1509],{},[26,1506,1507],{},"201"," + ",[26,1510,1511],{},"Location",[15,1513,1514,1515,1518,1519,1522],{},"Express를 쓴다면 ",[26,1516,1517],{},"sendProblem","을 에러 처리 미들웨어(",[26,1520,1521],{},"(err, req, res, next) => ...",")로 등록하면 같은 구조가 된다.",[186,1524],{},[10,1526,1528],{"id":1527},"프론트엔드에서-받기","프론트엔드에서 받기",[15,1530,1531],{},"모든 에러가 같은 모양이니, 처리 코드도 하나면 된다.",[19,1533,1535],{"className":21,"code":1534,"language":23,"meta":24,"style":24},"async function api(url, options) {\n  const res = await fetch(url, options);\n  if (res.ok) return res.status === 204 ? null : res.json();\n\n  const problem = await res.json().catch(() => ({ status: res.status, title: res.statusText }));\n  const error = new Error(problem.detail ?? problem.title);\n  error.problem = problem;\n  throw error;\n}\n\ntry {\n  await api(\"\u002Fusers\", { method: \"POST\", body: JSON.stringify(form) });\n} catch (e) {\n  const p = e.problem;\n  if (p?.code === \"validation_failed\") {\n    p.errors.forEach(({ field, message }) => showFieldError(field, message));\n  } else if (p?.code === \"email_taken\") {\n    showFieldError(\"email\", p.detail);\n  } else {\n    toast(`문제가 발생했습니다. (문의 시 코드: ${p?.traceId ?? \"없음\"})`);\n  }\n}\n",[26,1536,1537,1558,1576,1611,1615,1645,1666,1676,1684,1688,1692,1699,1728,1738,1750,1764,1793,1811,1823,1831,1856,1860],{"__ignoreMap":24},[29,1538,1539,1541,1543,1546,1548,1551,1553,1556],{"class":31,"line":32},[29,1540,1167],{"class":669},[29,1542,1170],{"class":669},[29,1544,1545],{"class":699}," api",[29,1547,642],{"class":62},[29,1549,1550],{"class":719},"url",[29,1552,103],{"class":62},[29,1554,1555],{"class":719},"options",[29,1557,847],{"class":62},[29,1559,1560,1562,1565,1567,1570,1573],{"class":31,"line":39},[29,1561,853],{"class":669},[29,1563,1564],{"class":99}," res",[29,1566,739],{"class":669},[29,1568,1569],{"class":669}," await",[29,1571,1572],{"class":699}," fetch",[29,1574,1575],{"class":62},"(url, options);\n",[29,1577,1578,1580,1583,1586,1589,1592,1595,1598,1601,1604,1607,1609],{"class":31,"line":46},[29,1579,884],{"class":669},[29,1581,1582],{"class":62}," (res.ok) ",[29,1584,1585],{"class":669},"return",[29,1587,1588],{"class":62}," res.status ",[29,1590,1591],{"class":669},"===",[29,1593,1594],{"class":99}," 204",[29,1596,1597],{"class":669}," ?",[29,1599,1600],{"class":99}," null",[29,1602,1603],{"class":669}," :",[29,1605,1606],{"class":62}," res.",[29,1608,464],{"class":699},[29,1610,864],{"class":62},[29,1612,1613],{"class":31,"line":53},[29,1614,50],{"emptyLinePlaceholder":49},[29,1616,1617,1619,1622,1624,1626,1628,1630,1633,1636,1639,1642],{"class":31,"line":59},[29,1618,853],{"class":669},[29,1620,1621],{"class":99}," problem",[29,1623,739],{"class":669},[29,1625,1569],{"class":669},[29,1627,1606],{"class":62},[29,1629,464],{"class":699},[29,1631,1632],{"class":62},"().",[29,1634,1635],{"class":699},"catch",[29,1637,1638],{"class":62},"(() ",[29,1640,1641],{"class":669},"=>",[29,1643,1644],{"class":62}," ({ status: res.status, title: res.statusText }));\n",[29,1646,1647,1649,1652,1654,1656,1658,1661,1663],{"class":31,"line":78},[29,1648,853],{"class":669},[29,1650,1651],{"class":99}," error",[29,1653,739],{"class":669},[29,1655,1314],{"class":669},[29,1657,706],{"class":699},[29,1659,1660],{"class":62},"(problem.detail ",[29,1662,1248],{"class":669},[29,1664,1665],{"class":62}," problem.title);\n",[29,1667,1668,1671,1673],{"class":31,"line":83},[29,1669,1670],{"class":62},"  error.problem ",[29,1672,761],{"class":669},[29,1674,1675],{"class":62}," problem;\n",[29,1677,1678,1681],{"class":31,"line":89},[29,1679,1680],{"class":669},"  throw",[29,1682,1683],{"class":62}," error;\n",[29,1685,1686],{"class":31,"line":126},[29,1687,629],{"class":62},[29,1689,1690],{"class":31,"line":131},[29,1691,50],{"emptyLinePlaceholder":49},[29,1693,1694,1697],{"class":31,"line":137},[29,1695,1696],{"class":669},"try",[29,1698,709],{"class":62},[29,1700,1701,1704,1706,1708,1710,1713,1716,1719,1721,1723,1725],{"class":31,"line":626},[29,1702,1703],{"class":669},"  await",[29,1705,1545],{"class":699},[29,1707,642],{"class":62},[29,1709,530],{"class":42},[29,1711,1712],{"class":62},", { method: ",[29,1714,1715],{"class":42},"\"POST\"",[29,1717,1718],{"class":62},", body: ",[29,1720,1137],{"class":99},[29,1722,918],{"class":62},[29,1724,1142],{"class":699},[29,1726,1727],{"class":62},"(form) });\n",[29,1729,1730,1733,1735],{"class":31,"line":812},[29,1731,1732],{"class":62},"} ",[29,1734,1635],{"class":669},[29,1736,1737],{"class":62}," (e) {\n",[29,1739,1740,1742,1745,1747],{"class":31,"line":817},[29,1741,853],{"class":669},[29,1743,1744],{"class":99}," p",[29,1746,739],{"class":669},[29,1748,1749],{"class":62}," e.problem;\n",[29,1751,1752,1754,1757,1759,1762],{"class":31,"line":823},[29,1753,884],{"class":669},[29,1755,1756],{"class":62}," (p?.code ",[29,1758,1591],{"class":669},[29,1760,1761],{"class":42}," \"validation_failed\"",[29,1763,847],{"class":62},[29,1765,1766,1769,1772,1775,1778,1780,1782,1785,1787,1790],{"class":31,"line":850},[29,1767,1768],{"class":62},"    p.errors.",[29,1770,1771],{"class":699},"forEach",[29,1773,1774],{"class":62},"(({ ",[29,1776,1777],{"class":719},"field",[29,1779,103],{"class":62},[29,1781,638],{"class":719},[29,1783,1784],{"class":62}," }) ",[29,1786,1641],{"class":669},[29,1788,1789],{"class":699}," showFieldError",[29,1791,1792],{"class":62},"(field, message));\n",[29,1794,1795,1797,1799,1802,1804,1806,1809],{"class":31,"line":867},[29,1796,982],{"class":62},[29,1798,985],{"class":669},[29,1800,1801],{"class":669}," if",[29,1803,1756],{"class":62},[29,1805,1591],{"class":669},[29,1807,1808],{"class":42}," \"email_taken\"",[29,1810,847],{"class":62},[29,1812,1813,1816,1818,1820],{"class":31,"line":872},[29,1814,1815],{"class":699},"    showFieldError",[29,1817,642],{"class":62},[29,1819,565],{"class":42},[29,1821,1822],{"class":62},", p.detail);\n",[29,1824,1825,1827,1829],{"class":31,"line":881},[29,1826,982],{"class":62},[29,1828,985],{"class":669},[29,1830,709],{"class":62},[29,1832,1833,1836,1838,1841,1843,1846,1848,1851,1854],{"class":31,"line":897},[29,1834,1835],{"class":699},"    toast",[29,1837,642],{"class":62},[29,1839,1840],{"class":42},"`문제가 발생했습니다. (문의 시 코드: ${",[29,1842,15],{"class":62},[29,1844,1845],{"class":42},"?.",[29,1847,429],{"class":62},[29,1849,1850],{"class":669}," ??",[29,1852,1853],{"class":42}," \"없음\"})`",[29,1855,1124],{"class":62},[29,1857,1858],{"class":31,"line":907},[29,1859,805],{"class":62},[29,1861,1862],{"class":31,"line":928},[29,1863,629],{"class":62},[15,1865,1866,1867,1869],{},"사용자가 고객센터에 ",[26,1868,429],{},"를 알려주면, 서버 로그에서 그 요청의 실제 에러를 바로 찾을 수 있다.",[186,1871],{},[10,1873,1875],{"id":1874},"정리-왜-알아두면-좋은가","정리: 왜 알아두면 좋은가",[193,1877,1878,1888],{},[196,1879,1880],{},[199,1881,1882,1885],{},[202,1883,1884],{},"원칙",[202,1886,1887],{},"방법",[212,1889,1890,1899,1910,1923,1933,1943,1951],{},[199,1891,1892,1894],{},[217,1893,172],{},[217,1895,1896,1897,361],{},"RFC 9457 Problem Details (",[26,1898,416],{},[199,1900,1901,1904],{},[217,1902,1903],{},"프로그램이 분기할 기준",[217,1905,1906,1907,1909],{},"변하지 않는 ",[26,1908,26],{}," (메시지 문자열로 분기하지 않기)",[199,1911,1912,1915],{},[217,1913,1914],{},"사람이 읽을 설명",[217,1916,1917,1919,1920,1922],{},[26,1918,368],{},"(종류), ",[26,1921,391],{},"(이번 건)",[199,1924,1925,1928],{},[217,1926,1927],{},"폼 검증 실패",[217,1929,1930,1932],{},[26,1931,426],{}," 배열로 필드별 한 번에",[199,1934,1935,1938],{},[217,1936,1937],{},"문의 대응",[217,1939,1940,1942],{},[26,1941,429],{},"로 서버 로그와 연결",[199,1944,1945,1948],{},[217,1946,1947],{},"보안",[217,1949,1950],{},"예상 못 한 에러는 일반 메시지로, 상세는 로그에만",[199,1952,1953,1956],{},[217,1954,1955],{},"일관성 유지",[217,1957,1958],{},"에러 클래스 + 에러 응답 함수 한 곳",[15,1960,1961],{},"상태 코드가 \"어떤 종류의 실패인가\"를 알려준다면, 에러 응답 본문은 \"그래서 무엇을 하면 되는가\"를 알려준다. 형식을 한 번 정해두면 API가 늘어나도 프론트엔드의 에러 처리 코드는 늘어나지 않는다.",[1963,1964,1965],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":24,"searchDepth":39,"depth":39,"links":1967},[1968,1969,1970,1971,1972,1973,1974],{"id":12,"depth":39,"text":13},{"id":190,"depth":39,"text":191},{"id":317,"depth":39,"text":318},{"id":451,"depth":39,"text":452},{"id":651,"depth":39,"text":652},{"id":1527,"depth":39,"text":1528},{"id":1874,"depth":39,"text":1875},"어떤 API는 문자열을, 어떤 API는 { error }를, 어떤 API는 { message, code }를 돌려준다면 프론트엔드는 에러마다 다른 코드를 써야 한다. 좋은 에러 응답의 조건과 표준 형식인 RFC 9457 Problem Details, 필드별 검증 에러, 내부 정보 숨기기, Node.js로 한 곳에서 처리하는 방법까지 정리했다.","md",{"date":1978,"field":1979,"tags":1980},"2026.10.08","backend",[1981,1982],"api","http","\u002Fko\u002Fapi-error-response-format",{"title":5,"description":1975},{"loc":1983},"ko\u002Fapi-error-response-format","Ajxsa1K8UdT8Mjxnn1pnkPyIBlWb-Znv_wXHo2cOsQY",[1989,2000,2003,2011,2019,2027,2035,2043,2050,2061,2069,2077,2089,2097,2106,2112,2118,2125,2131,2136,2143,2149,2155,2161,2167,2174,2180,2187,2196,2204,2210,2217,2224,2230,2237,2244,2252,2259,2266,2275,2281,2288,2295,2301,2309,2316,2324,2330],{"path":1990,"title":1991,"description":1992,"meta":1993},"\u002Fko\u002Fadsense-ads-txt-and-seo-indexing-bug","애드센스 ads.txt 경고를 받고 파헤치다가 찾은 진짜 색인 버그","구글 애드센스가 ads.txt 문제를 알려왔는데, 확인해보니 파일은 멀쩡했다. 대신 서치콘솔 색인 수가 적었던 진짜 원인을 Nuxt Content 슬러그 불일치 버그에서 찾은 과정을 정리한다.",{"date":1994,"field":1995,"tags":1996},"2026.09.17","blog",[1997,1998,1999],"seo","adsense","nuxt-content",{"path":1983,"title":5,"description":1975,"meta":2001},{"date":1978,"field":1979,"tags":2002},[1981,1982],{"path":2004,"title":2005,"description":2006,"meta":2007},"\u002Fko\u002Fcors-guide","CORS 에러 완전 정리: 왜 막히는지부터 preflight, credentials까지 올바르게 해결하기","'has been blocked by CORS policy' 에러는 서버가 아니라 브라우저가 막은 것이다. 같은 출처 정책, 단순 요청과 preflight, 쿠키를 보내는 요청, 응답 헤더 노출까지 실제 브라우저로 확인한 결과와 함께 정리하고, mode: 'no-cors' 같은 잘못된 해결법도 짚어봤다.",{"date":1978,"field":1979,"tags":2008},[1982,2009,2010],"web-security","nodejs",{"path":2012,"title":2013,"description":2014,"meta":2015},"\u002Fko\u002Fcss-has-selector","CSS :has() 선택자 실전 가이드: 자바스크립트 없이 부모를 선택하는 법","체크하면 카드가 강조되고, 입력이 틀리면 폼 전체가 반응하고, 별점에 마우스를 올리면 앞의 별까지 칠해진다. 예전엔 자바스크립트가 필요했던 일을 CSS :has() 한 줄로 해결하는 실전 예제를 직접 눌러보며 정리했다.",{"date":1978,"field":2016,"tags":2017},"frontend",[2018],"css",{"path":2020,"title":2021,"description":2022,"meta":2023},"\u002Fko\u002Fcss-layouts","CSS Flexbox 완전 정복 가이드","Flexbox를 활용한 반응형 레이아웃 구현 방법과 실전 예제. 수직 정렬, 네비게이션 바, 카드 레이아웃까지 완벽 정리!",{"date":2024,"image":2025,"field":2016,"tags":2026},"2025.01.25","css.jpg",[2018],{"path":2028,"title":2029,"description":2030,"meta":2031},"\u002Fko\u002Fcss-login-form","로그인","로그인 UI를 그려보자",{"date":2032,"field":2016,"tags":2033},"2025.03.29",[2034,2018],"html",{"path":2036,"title":2037,"description":2038,"meta":2039},"\u002Fko\u002Fcsv-parser-cleaning","복잡한 CSV 데이터를 안전하게 파싱하는 방법","JavaScript에서 큰따옴표, 줄바꿈, 쉼표 등 복잡한 CSV 데이터를 안전하게 객체로 변환하는 전체 과정 설명",{"date":2040,"field":2016,"tags":2041},"2025.06.19",[2042],"javascript",{"path":2044,"title":2045,"description":2046,"meta":2047},"\u002Fko\u002Fdebounce-guide","debounce와 throttle이란??","반복되는 함수 호출을 제어하는 기술인 디바운스(debounce)와 쓰로틀(throttle)을 알아보자.",{"date":2048,"field":2016,"tags":2049},"2025.03.26",[2042],{"path":2051,"title":2052,"description":2053,"meta":2054},"\u002Fko\u002Fdeclarative-vs-procedural-programming","선언적 프로그래밍 vs 절차형 프로그래밍","선언적 프로그래밍과 절차형 프로그래밍은 서로 대비되는 대표적인 패러다임이다. 두 패러다임의 차이를 알아보고, 각 패러다임에 해당하는 언어와 Vue\u002FReact의 특징을 살펴보자.",{"date":2055,"field":2056,"tags":2057},"2025.05.24","concepts",[2058,2059,2060],"paradigm","vue","react",{"path":2062,"title":2063,"description":2064,"meta":2065},"\u002Fko\u002Fdesign-guide","Design-Guide","A comprehensive guide on design principles and best practices for developers.",{"date":2066,"field":2016,"tags":2067},"2025.01.19",[2068],"design-system",{"path":2070,"title":2071,"description":2072,"meta":2073},"\u002Fko\u002Fdikw-pyramid","DIKW 피라미드 정리: 데이터가 지혜가 되기까지","Data, Information, Knowledge, Wisdom 4단계로 구성된 DIKW 피라미드 개념을 로그\u002F분석 데이터 같은 실제 개발 사례에 대입해서 정리한다.",{"date":2074,"field":2056,"tags":2075},"2026.09.18",[2076],"data",{"path":2078,"title":2079,"description":2080,"meta":2081},"\u002Fko\u002Fdisplaying-commits-with-github-actions","깃허브 액션으로 커밋 로그를 블로그에 띄우기: Nuxt와 Vercel 활용법","깃허브 액션을 통해 커밋 데이터를 자동으로 수집하고, Nuxt와 Vercel로 UI에 노출하는 방법을 소개합니다.",{"date":2082,"image":2083,"field":2084,"tags":2085},"2025.02.28","github-commits.jpg","infra",[2086,2087,2088],"github-actions","vercel","nuxt",{"path":2090,"title":2091,"description":2092,"meta":2093},"\u002Fko\u002Fdocker-auto-build-run","로컬에서 커밋 시 도커 빌드 후 컨테이너 시작하기","로컬에서 커밋 시 도커 빌드 후 컨테이너 시작하기.",{"date":2094,"field":2084,"tags":2095},"2025.03.10",[2096],"docker",{"path":2098,"title":2099,"description":2100,"meta":2101},"\u002Fko\u002Fhow-to-mount-storage","라즈베리파이4에 저장장치 마운트 시키기","라즈베리파이에 저장장치를 연결하고 파티션 생성부터 포맷, 마운트까지의 전체 과정을 정리한 기록입니다.",{"date":2102,"field":2084,"tags":2103},"2025.07.11",[2104,2105],"raspberry-pi","linux",{"path":2107,"title":2108,"description":2108,"meta":2109},"\u002Fko\u002Fhtml","HTML이란 무엇인가",{"date":2024,"image":2110,"field":2016,"tags":2111},"html.jpg",[2034],{"path":2113,"title":2114,"description":2115,"meta":2116},"\u002Fko\u002Fhtml-features-without-javascript","자바스크립트 없이 HTML만으로 되는 것들: 아직도 div로 다 만들고 있다면","아코디언, 팝오버, 모달, 자동완성, 폼 검증, 이미지 지연 로딩까지. 라이브러리 없이 HTML 태그와 속성만으로 해결되는 기능을 예제와 함께 정리했다. 코드는 줄고 접근성은 덤으로 따라온다.",{"date":1978,"field":2016,"tags":2117},[2034],{"path":2119,"title":2120,"description":2121,"meta":2122},"\u002Fko\u002Fhtml2","미치광이 카드 컴포넌트","미치광이 카드 컴포넌트는 어떤 느낌일까",{"date":2123,"field":2016,"tags":2124},"2025.03.28",[2034,2018],{"path":2126,"title":2127,"description":2128,"meta":2129},"\u002Fko\u002Fhttp-cache-control-guide","HTTP 캐시 제대로 쓰기: Cache-Control, ETag, no-cache와 no-store의 차이","no-cache는 '캐시하지 마라'가 아니다. Cache-Control의 max-age, no-cache, no-store, s-maxage, immutable이 각각 어떻게 동작하는지 실제 브라우저로 서버에 요청이 몇 번 가는지 확인하고, ETag와 304, 배포해도 옛날 파일이 보이는 문제, Vercel CDN 캐시까지 정리했다.",{"date":1978,"field":1979,"tags":2130},[1982,2087],{"path":156,"title":2132,"description":2133,"meta":2134},"HTTP 상태 코드 올바르게 쓰기: 400 vs 422, 401 vs 403, 200 vs 201 vs 204 헷갈릴 때 보는 정리","에러인데 200에 success: false를 담고 있다면, 클라이언트와 모니터링 도구가 실패를 알 수 없다. 상황별로 어떤 상태 코드를 써야 하는지, 401과 403, 400과 422처럼 헷갈리는 코드의 차이, 301과 308처럼 POST가 GET으로 바뀌는 리다이렉트 함정까지 정리했다.",{"date":1978,"field":1979,"tags":2135},[1982,1981],{"path":2137,"title":2138,"description":2138,"meta":2139},"\u002Fko\u002Fhttps-guide","Let's Encrypt를 이용해서 HTTPS 적용하기",{"date":2140,"field":2084,"tags":2141},"2025.03.11",[2142],"https",{"path":2144,"title":2145,"description":2146,"meta":2147},"\u002Fko\u002Fjavascript-async-error-handling","자바스크립트 비동기 에러 올바르게 처리하기: try\u002Fcatch가 못 잡는 경우부터 Promise.all vs allSettled까지","try\u002Fcatch로 감쌌는데 에러가 새어 나가고, 404인데 fetch는 성공했다고 한다. await 빠뜨린 try\u002Fcatch, return vs return await, fetch의 res.ok, Promise.all과 allSettled, 반복문 속 await, 타임아웃과 요청 취소까지 비동기 에러 처리의 함정을 직접 실행해보며 정리했다.",{"date":1978,"field":2016,"tags":2148},[2042],{"path":2150,"title":2151,"description":2152,"meta":2153},"\u002Fko\u002Fjavascript-event-loop","자바스크립트 이벤트 루프 완전 정복: 마이크로태스크와 매크로태스크의 실행 순서","setTimeout(0)보다 Promise.then이 먼저 실행되는 이유는? 콜 스택, 태스크 큐, 마이크로태스크 큐가 어떤 순서로 돌아가는지 예제로 정리하고, 브라우저와 Node.js의 차이, 실무에서 UI 멈춤을 피하는 방법까지 알아보자.",{"date":1978,"field":2056,"tags":2154},[2042,2010],{"path":2156,"title":2157,"description":2158,"meta":2159},"\u002Fko\u002Fjavascript-higher-order-functions","자바스크립트 고차 함수 완전 정복: map, filter, reduce부터 직접 만드는 once, memoize까지","함수를 인자로 받거나 함수를 반환하는 고차 함수. map, filter, reduce를 제대로 쓰는 법부터 once, memoize, pipe, 커링처럼 실무에서 바로 쓰는 고차 함수를 직접 만들어보고, ['1','2','3'].map(parseInt) 같은 함정까지 정리했다.",{"date":1978,"field":2016,"tags":2160},[2042],{"path":2162,"title":2163,"description":2164,"meta":2165},"\u002Fko\u002Fjavascript-nullish-coalescing-optional-chaining","자바스크립트 ?? vs || 완벽 정리: null, undefined, 0, 빈 문자열을 올바르게 처리하는 법","볼륨 0이 50으로 바뀌고, 빈 닉네임이 '익명'이 되는 버그는 대부분 || 때문이다. ??와 ||의 차이, ?. 옵셔널 체이닝, ??=, 기본 매개변수가 적용되는 조건, null 검사하는 올바른 방법까지 직접 값을 넣어보며 정리했다.",{"date":1978,"field":2016,"tags":2166},[2042],{"path":2168,"title":2169,"description":2170,"meta":2171},"\u002Fko\u002Fjs-data-01","JavaScript 데이터01","JavaScript 데이터 다루는 문제를 풀어보자",{"date":2172,"field":2016,"tags":2173},"2025.03.08",[2042],{"path":2175,"title":2176,"description":2177,"meta":2178},"\u002Fko\u002Fjs-data-02","JavaScript 데이터02","복잡한 데이터 구조를 다루는 실전 문제를 해결해보자.",{"date":2172,"field":2016,"tags":2179},[2042],{"path":2181,"title":2182,"description":2183,"meta":2184},"\u002Fko\u002Fjwt-vs-session-auth","JWT vs 세션 인증 비교: 무엇을 써야 할까? 저장 위치, 로그아웃, 보안까지 정리","JWT는 암호화가 아니라 서명이라서 누구나 내용을 읽을 수 있다. 세션과 JWT가 각각 어떻게 동작하는지, 강제 로그아웃이 어려운 이유, localStorage와 httpOnly 쿠키 중 어디에 저장해야 하는지, 리프레시 토큰까지 직접 토큰을 디코딩하고 변조해보며 정리했다.",{"date":1978,"field":1979,"tags":2185},[2186,2009],"auth",{"path":2188,"title":2189,"description":2190,"meta":2191},"\u002Fko\u002Fmarkdown-guid","마크다운 문법","마크다운 문법을 알아보자",{"date":2192,"image":2193,"field":1995,"tags":2194},"2025.03.02","markdown.webp",[2195],"markdown",{"path":2197,"title":2198,"description":2199,"meta":2200},"\u002Fko\u002Fminio-guide","MinIO 완벽 가이드: 설치부터 Node.js 연동까지","MinIO는 오픈소스 기반의 고성능 객체 스토리지 서버입니다. AWS S3와 호환되는 API를 제공하여 클라우드 네이티브 애플리케이션을 위한 완벽한 스토리지 솔루션으로 자리잡고 있습니다.",{"date":2201,"field":1979,"tags":2202},"2025.11.23",[2203,2010],"minio",{"path":2205,"title":2206,"description":2207,"meta":2208},"\u002Fko\u002Fnitro-wildcard-redirect-url-migration","글 주소 프리픽스를 통째로 바꿔야 할 때: Nitro wildcard 리다이렉트로 안전하게 옮기기","\u002Fblog\u002F[슬러그]로 쓰던 글 주소를 \u002Fko\u002F[슬러그]로 옮기면서, 기존 링크\u002F북마크를 하나도 안 깨뜨리고 처리한 방법. Nitro routeRules의 와일드카드 리다이렉트 패턴과 실제로 같이 바꿔야 했던 범위를 정리한다.",{"date":1978,"field":1995,"tags":2209},[2088,1997],{"path":2211,"title":2212,"description":2213,"meta":2214},"\u002Fko\u002Fnode-simple-server","Node.js 간단한 서버 만들기","Node.js로 간단한 HTTP 서버를 만드는 방법",{"date":2215,"field":1979,"tags":2216},"2025.01.30",[2010],{"path":2218,"title":2219,"description":2220,"meta":2221},"\u002Fko\u002Fnodejs-graceful-shutdown","Node.js 서버 안전하게 종료하기 (Graceful Shutdown): 배포할 때마다 요청이 끊기는 이유","배포나 재시작 순간 처리 중이던 요청이 끊긴다면 종료 신호(SIGTERM)를 처리하지 않았기 때문이다. server.close()로 진행 중인 요청을 마치고 끄는 법, keep-alive 연결 때문에 바로 안 꺼지는 함정, Docker와 PM2에서 신호가 전달되지 않는 문제까지 실제로 실행해 확인하며 정리했다.",{"date":1978,"field":1979,"tags":2222},[2010,2096,2223],"pm2",{"path":2225,"title":2226,"description":2227,"meta":2228},"\u002Fko\u002Fnuxt-colormode","Nuxt3 다크모드 적용하기","Nuxt3에 다크모드 적용하여 관리하기",{"date":2032,"field":2016,"tags":2229},[2088],{"path":2231,"title":2232,"description":2233,"meta":2234},"\u002Fko\u002Fnuxt-content-vercel-empty-query-sqlite","배포만 하면 블로그 글이 하나도 안 보이던 버그: Nuxt Content와 Vercel의 \u002Ftmp 문제","로컬에서는 멀쩡한데 Vercel에 올리면 queryCollection()이 빈 배열만 반환하던 버그를 추적한 과정. 원인은 @nuxt\u002Fcontent가 Vercel의 읽기 전용 파일시스템을 지원하기 전 버전에 고정돼 있었던 것.",{"date":2235,"field":1995,"tags":2236},"2026.10.07",[1999,2087],{"path":2238,"title":2239,"description":2240,"meta":2241},"\u002Fko\u002Fnuxt-runtimeconfig-appconfig","Nuxt 설정 runtimeConfig vs app.config 완전 정복","Nuxt3에서 전역 설정을 어떻게 관리하고, 어떤 기준으로 나누어야 할까? 다크모드 예시부터 실무 기준 설정 전략까지 총정리",{"date":2242,"field":2016,"tags":2243},"2025.06.16",[2088],{"path":2245,"title":2246,"description":2247,"meta":2248},"\u002Fko\u002Fnuxt-useasyncdata-cache-error","useAsyncData 캐싱 문제와 Key 동적 설정으로 해결하기","이전 포스트의 데이터가 계속 출력되는 캐싱 관련 문제를 해결하는 방법",{"date":2249,"field":2016,"tags":2250,"image":2251},"2025.01.24",[2088],"cache.jpg",{"path":2253,"title":2254,"description":2255,"meta":2256},"\u002Fko\u002Fnuxt-vercel-sql-error","Nuxt 3에서 Vercel 배포 시 발생한 md 파일 로딩 문제 해결기","Nuxt 3 웹 어플리케이션에서 Vercel 배포 환경에서 발생한 md 파일 로딩 문제를 분석하고 해결한 방법에 대해 공유합니다.",{"date":2249,"image":2257,"field":2016,"tags":2258},"ssg.jpg",[2088,1999,2087],{"path":2260,"title":2261,"description":2262,"meta":2263},"\u002Fko\u002Fnuxt3-pinia-guide","nuxt3 Pinia 적용하기","Nuxt3 프로젝트에서 Pinia를 적용해보자 @pinia\u002Fnuxt",{"date":2032,"field":2016,"tags":2264},[2088,2265],"pinia",{"path":2267,"title":2268,"description":2269,"meta":2270},"\u002Fko\u002Fnuxt3-unit-test","Nuxt 프로젝트에 유닛 테스트 코드 추가하기","Nuxt 3 프로젝트에서 Vitest를 활용한 테스트 환경 설정과 유틸리티 함수 테스트 방법",{"date":2271,"image":2272,"field":2016,"tags":2273},"2025.03.07","unit-test.jpg",[2088,2274],"vitest",{"path":2276,"title":2277,"description":2278,"meta":2279},"\u002Fko\u002Fpm2-guide","프로세스 매니저 PM2","배포환경에서 유용하게 사용할 수 있는 프로세스 매니저를 알아보자.",{"date":2094,"field":2084,"tags":2280},[2223,2010],{"path":2282,"title":2283,"description":2284,"meta":2285},"\u002Fko\u002Freact-createportal","React createPortal 완벽 가이드","React의 `createPortal`을 활용한 UI 구현법, 활용 사례, 장단점 및 코드 예제를 소개합니다.",{"date":2286,"field":2016,"tags":2287},"2025.01.27",[2060],{"path":2289,"title":2290,"description":2291,"meta":2292},"\u002Fko\u002Frouting","Routing","Nuxt file-system routing creates a route for every file in the pages\u002F directory.",{"date":2293,"field":2016,"tags":2294},"2025.01.22",[2088],{"path":2296,"title":2297,"description":2298,"meta":2299},"\u002Fko\u002Fsemantic-html-common-mistakes","의미 있는 HTML 쓰기: 대부분이 하는 시맨틱 HTML 실수 7가지","화면에서는 똑같아 보여도 div로 만든 버튼, label 없는 입력칸, 크기로 고른 제목 태그는 키보드 사용자와 스크린 리더, 검색 엔진에게 전혀 다르게 보인다. 직접 눌러볼 수 있는 예제로 흔한 시맨틱 HTML 실수와 고치는 법을 정리했다.",{"date":1978,"field":2016,"tags":2300},[2034],{"path":2302,"title":2303,"description":2304,"meta":2305},"\u002Fko\u002Ftanstack-query-guide","TanStack Query란 무엇인가?","TanStack Query가 웹 애플리케이션에서 데이터 가져오기, 캐싱, 상태 관리를 어떻게 개선하는지 알아본다.",{"date":2306,"field":2016,"tags":2307},"2025.04.15",[2060,2308],"tanstack-query",{"path":2310,"title":2311,"description":2312,"meta":2313},"\u002Fko\u002Fuse-context","리엑트 상태관리 useContext()","React에서 `useContext`를 사용하면 컴포넌트 트리에 깊이 중첩된 컴포넌트에서도 prop drilling 없이 상태를 공유할 수 있습니다. 이 글에서는 `useContext`의 개념, 사용 방법, 장단점, 그리고 실전 예제를 함께 알아보겠습니다.",{"date":2314,"field":2016,"tags":2315},"2025.02.03",[2060],{"path":2317,"title":2318,"description":2319,"meta":2320},"\u002Fko\u002Fvite-plugin-style-inject","리엑티 컴포넌트를 패키지 빌드 시 CSS 같이 적용시키기","dist에 css에 파일이 생성되었으나, 적용 안 되는 이유를 알아보고 에러를 처리하자",{"date":2321,"field":2016,"tags":2322},"2025.04.06",[2323,2060],"vite",{"path":2325,"title":2326,"description":2327,"meta":2328},"\u002Fko\u002Fvue-component-guide","Vue의 \u003Ccomponent :is \u002F> 완벽 정리: 동적 렌더링의 모든 것","Vue에서 \u003Ccomponent :is \u002F>를 활용한 동적 컴포넌트 렌더링 방법과 VNode, 컴포넌트 객체의 차이를 실전 예제로 이해하기",{"date":2024,"field":2016,"tags":2329},[2059],{"path":2331,"title":2332,"description":2333,"meta":2334},"\u002Fko\u002Fvue-query-ref-value-trap-nuxt3","Vue Query에서 데이터가 안 보이는 이유? Nuxt 3와 Ref 구조의 함정","Nuxt 3 + vue-query를 사용할 때 API 데이터가 `v-if` 조건문에서 제대로 표시되지 않는 현상을 해결한 경험을 바탕으로, Ref 구조와 template 디렉티브에서의 차이를 자세히 설명합니다.",{"date":2335,"field":2016,"tags":2336},"2025.06.08",[2088,2059,2308],1791482016793]