Troubleshooting Guide

Troubleshooting

Most issues come from Notion access, environment variables, metadata mismatch, or stale generated output.

Notion object_not_found

The integration cannot access the requested data source. Connect the integration to the Posts data source and verify that you are using the data source id, not only the database id.

The home page is empty

• At least one row must have status=Public.
• The row must have type=Post.
• The date field should be set.
• Run a production build and check logs.

Category pages are empty

The Notion category value must exactly match a category name in brand.ts. Development is different from development and different from 개발.

Images do not load

• Check NOTION_IMAGE_SIGNING_SECRET.
• Check whether the image is a Notion file, page cover, or external URL.
• Add external hosts to next.config.ts remotePatterns.

Production does not update

Wait for ISR, call /api/revalidate, or redeploy if environment variables changed.