Notion API 변경 대응: morethan-log 오류 해결 로그

status

Public

date

Feb 9, 2026

slug

fix-morethan-log-notion-api-error

summary

최근 Notion API 데이터 구조 변경(중첩된 value 속성)으로 인해 morethan-log 블로그 게시물이 로딩되지 않는 오류를 해결합니다. getPosts.ts 및 주요 파일의 코드 수정 방법을 정리했습니다.

type

Post

문제 원인: 중첩된 value 속성

Notion API 업데이트로 인해 블록(Block) 데이터의 구조가 변경되었다. 기존에는 block[id].value에서 바로 데이터에 접근할 수 있었으나, 업데이트 이후 실제 데이터가 한 단계 더 깊은 value 내부에 담기게 되었다.

구조를 뜯어보니 value 껍데기가 하나 더 생긴 형태다.


{
  value: { // <--- 이게이 새로 생김
    id: '2c1 .... bc27',
    ...
    value: { // <--- 기존 데이터는 여기로 밀려남
       schema: {
         'NX\\Q': [Object],
         WxpT: [Object],
         ...
       },
    }
  }
}

즉, 접근 경로가 아래와 같이 바뀌었다.

변경 전: block[id].value

변경 후: block[id].value.value

따라서 기존 코드에서 API 응답을 파싱하는 경로를 수정해줘야만 정상적으로 데이터를 불러올 수 있다.

해결 방법: 코드 수정

수정이 필요한 주요 파일은 총 3개다.

각 파일에서 데이터 접근 경로를 변경된 구조에 맞게 수정해야 한다. 또한 타입스크립트 에러 방지를 위해 as any를 사용하여 일시적으로 타입을 우회했다.

1. src/apis/notion-client/getPosts.ts

블로그 게시물 목록을 가져오는 파일이다. 컬렉션 스키마와 메타데이터를 가져오는 부분을 수정해야 한다.

Before:


const collection = Object.values(response.collection)[0]?.value
const block = response.block
const schema = collection?.schema

const rawMetadata = block[id].value

// ... (중략)

properties.createdTime = new Date(block[id].value?.created_time).toString()
properties.fullWidth = (block[id].value?.format as any)?.page_full_width ?? false

After:


const collection: any = Object.values(response.collection)[0]?.value
const block = response.block
const schema = collection?.value?.schema // <--- 수정됨

const rawMetadata = (block[id].value as any)?.value // <--- 수정됨

// ... (중략)

properties.createdTime = new Date((block[id].value as any)?.value?.created_time).toString() // <--- 수정됨
properties.fullWidth = ((block[id].value as any)?.value?.format as any)?.page_full_width ?? false // <--- 수정됨

2. src/libs/utils/notion/getPageProperties.ts

페이지의 속성(Properties)을 추출하는 유틸리티 파일이다.

Before:


const rawProperties = Object.entries(block?.[id]?.value?.properties || [])
// ...
const Block = block?.[id].value

After:


const rawProperties = Object.entries((block?.[id]?.value as any)?.value?.properties || []) // <--- 수정됨
// ...
const Block = (block?.[id].value as any)?.value // <--- 수정됨

3. src/routes/Detail/components/TableOfContents.tsx

나는 기존 기능에 커스텀하여 TOC를 생성하는 컴포넌트도 활용하는데, 이 부분도 깨진 것 같아 다음과 같이 수정했다.

Before:


const TableOfContents: React.FC<Props> = ({ recordMap, pageId }) => {
  const [activeId, setActiveId] = useState<string | null>(null)
  const block = recordMap.block[pageId]?.value

After:


const TableOfContents: React.FC<Props> = ({ recordMap, pageId }) => {
  const [activeId, setActiveId] = useState<string | null>(null)
  const block = (recordMap.block[pageId]?.value as any)?.value // <--- 수정됨

마무리

위의 코드 변경 사항을 모두 적용한 후, 로컬 환경에서 프로젝트를 다시 실행하여 블로그가 정상적으로 로드되는 것을 확인할 수 있었다.

물론 Notion API를 공짜로 사용하고 있었지만... 이런 식으로 예고 없이 API 변경점이 발생한 것을 놓쳐서, 어제는 해결 못 하는 줄 알고 멘붕에 빠졌었다. ㅠ 그래도 단순 디버깅으로 빠르게 원인을 찾아 해결 완료!

Notion API 변경 대응: morethan-log 오류 해결 로그

문제 원인: 중첩된 value 속성

해결 방법: 코드 수정

1. src/apis/notion-client/getPosts.ts

2. src/libs/utils/notion/getPageProperties.ts

3. src/routes/Detail/components/TableOfContents.tsx

마무리

Google Antigravity 시작하기 및 실제 프로젝트 구현해보기

[Review] AWS Certified Solutions Architect - Associate 합격 후기

노션(Notion)을 서비스 DB로 활용한 토이 프로젝트 후기

Ollama를 통한 LLM 모델 벤치마킹 후기