Question 1

왜 react-tweet을 사용하는 Next.js 사이트를 로딩할 때 'server error occurred'가 발생하나요?

Accepted Answer

react-tweet 라이브러리의 변경으로 인해 트윗 응답 본문에 필수 필드가 누락되어 서버 오류가 발생할 수 있습니다. 이 문제는 https://github.com/vercel/react-tweet/issues/218 에서 추적되고 있습니다. 해결을 위해 먼저 react-tweet을 최신 버전으로 업데이트하세요. 오류가 지속되면 임시 해결 방법을 적용하세요: 렌더링 전에 트윗 데이터에 __typename, lang, author와 같은 누락된 필드를 추가하여 패치합니다. 필요한 정확한 구조는 이슈를 확인하세요. 예를 들어, 응답에 `__typename: 'Tweet'`과 유효한 `author` 객체가 포함되도록 하세요.

Question 2

get_goals를 호출할 때 발생하는 Rybbit MCP 오류 -32602 'Output validation error: Expected number, received string'를 해결하는 방법은?

Accepted Answer

이것은 클라이언트 설정 문제가 아니라 서버 측 타입 버그입니다. Postgres의 `count(*)`는 bigint를 반환하며 Drizzle은 이를 문자열로 직렬화하지만, `get_goals`의 MCP 출력 스키마는 `meta.total`이 숫자이기를 기대하므로, 엄격한 MCP 클라이언트(예: Cursor)는 응답 전체를 거부합니다.

수정 방법 (self-hosted, `server/src/api/analytics/goals/getGoals.ts`에서):

```ts
const totalGoals = Number(totalGoalsResult[0]?.count ?? 0);
```

또는 SQL에서 캐스팅:

```ts
.select({ count: sql<number>`count(*)::int` })
```

또한 동일한 `count(*)` → `meta.total` 패턴을 사용하는 다른 analytics 목록 엔드포인트들도 확인하세요. 이들도 같은 방식으로 MCP 유효성 검사에 실패할 수 있습니다.

수정이 배포될 때까지의 우회 방법: HTTP API `GET /api/sites/:site/goals`를 직접 호출하고 `Number()`로 `meta.total`을 변환하거나, 영향을 받지 않는 raw 이벤트 카운트 도구를 사용하세요.

Question 3

data-site-id가 숫자로만 구성되어 있을 때 Rybbit 추적이 404 "Site not found"를 반환하는 이유는 무엇인가요?

Accepted Answer

숫자로만 구성된 새로운 텍스트 site `id`가 레거시 숫자형 `siteId`로 잘못 분류되어 `/api/site/tracking-config/...` 및 `/api/track`이 404를 반환할 수 있습니다. 임시 해결책으로, 대시보드에서 생성된 `data-site-id`를 사이트 메타데이터에 있는 더 작은 레거시 숫자형 `siteId`로 교체한 다음 페이지를 새로고침하세요. 영구적인 수정 방법은 백엔드가 먼저 정확한 텍스트 `sites.id`를 조회하고, 해당 조회가 실패하는 경우에만 `sites.siteId`로 폴백하는 것입니다.

Question 4

Cloudflare Workers 프록시 가이드에서 프록시 코드가 비어 있거나 누락된 이유는 무엇인가요?

Accepted Answer

이는 문서 Tabs 컴포넌트의 SSR/hydration 버그였습니다. 세 개의 `tabpanel` 요소는 렌더링되었지만 `role="tablist"` 탭 트리거가 생성되지 않았습니다. 패널이 `data-state="inactive"` 상태로 남아 있어 코드가 숨겨지고 컨테이너가 축소되었습니다. 현재 문서에서는 수정되었습니다. Ctrl+F5(macOS에서는 Cmd+Shift+R)로 페이지를 강력 새로고침하거나 캐시된 사이트 데이터를 삭제하세요. 이전/로컬 문서 빌드를 보고 있는 경우 문서를 업데이트하고 다시 빌드하세요. 임시 해결 방법으로 DevTools → Elements를 열어 숨겨진 `tabpanel` 요소를 찾은 다음 `hidden`/`data-state="inactive"` 스타일을 제거하거나 `display: block`으로 설정하면 코드를 보고 복사할 수 있습니다.

Question 5

사용자 보기에서 타임스탬프 위에 마우스를 올리면 테이블 열 크기가 조정되는 이유는 무엇인가요?

Accepted Answer

Chrome의 v2.6.0에서 알려진 버그입니다. 상대적 타임스탬프(예: "X minutes ago") 위에 호버하면 전체 날짜가 표시되면서 열 너비가 다시 조정됩니다. 이 문제는 다음 릴리스에서 수정될 예정입니다. 현재로서는 호버를 피하거나 새 버전이 나오면 업데이트하세요.

Rybbit

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트