러아니푸의 기록

📜 속도 이슈 발생

local에서는 1초를 넘는 경우를 본적이 없는데, 배포후 응답시간이 거의 2초까지 늘어나서 무슨 문제가 있다고 생각했습니다.

(캡처본에는 없지만 3초대도 본적이 있었습니다)

💊 원인 분석 및 해결 방법

아직 개발중인 프로젝트라서 vercel로 간단하게 배포하였는데 vercel 문제인가 싶어서 찾아봤더니 Region 설정이 문제였습니다.

데이터베이스의 Region은 서울로 되어있는데 워싱턴D.C(기본설정)에서 요청하고있으니.. 느릴수밖에 없었습니다.

저는 데이터베이스 위치와 동일하게 서울로 변경해주었습니다.

변경후 응답 속도가 평균 3배이상 빨라진것을 확인할 수 있습니다.

배포 연동시 Region 선택지가 없었어서 놓쳤던 부분이였습니다.

배포 또는 DB 연동등 완료후에 setting을 꼼꼼하게 확인해 보는 습관을 들여야겠습니다.

Sourcetree로 원격 프로젝트를 클론하는 도중 올바른 경로가 아니라는 문제가 발생하였습니다.

이 경우에는 git repository 경로에는 문제가 없는데도 에러가 발생하게 됩니다.

저는 같은 문제를 두 번 정도 겪어보아서 두가지 해결 방법을 공유드리겠습니다.

1. git 버전 변경으로 해결할 수 있는 문제

설정 -> Git -> Git 버전 : 내장 Git로 되돌리기 클릭

2. 연결된 계정에 SSH 키가 설정되지 않은 경우

설정 -> 계정 -> SSH 오류가 발생한 계정 더블클릭 -> 프로토콜을 HTTPS로 변경

앞으로도 관련해서 오류가 발생하게 된다면 추가로 해결 방법을 남겨두겠습니다.

📜 오류 발생

맥북을 새로 구매하여 기존에 작업하던 프로젝트를 맥북에서도 이어서 개발할 수 있도록 세팅하였습니다.

개발도 이어서 진행하고 Sourcetree로 commit 후 push를 진행하려고 하자 아래와 같은 오류가 발생하였습니다.

fatal: Authentication failed for {깃 주소}

인증 관련해서 발생한 문제같아서 알아보니 현재 깃허브에서는 인증을 토큰으로 진행한다고 합니다.

토큰을 발급받고 적용하여 문제를 해결해보도록 하겠습니다.

💊 해결 방법

1. github에서 토큰 발급 받기

setting -> Developer settings 클릭

Personal access tokens -> Tokens (classic) -> Generate new token -> Generate new token (classic) 클릭

Note : 토큰을 어디에 쓸지 명시합니다. ex) Macbook , Desktop ...

Expiration : 토큰 만료 기간입니다. 90 Days 라면 앞으로 90일 동안 해당 토큰을 통해 권한을 유지할 수 있습니다.

select scopes : 해당 토큰을 통해 접근할 수 있는 범위입니다.

설정을 마치셨다면 노란색으로 가려진 부분에 발급받은 토큰이 보여집니다.

페이지를 벗어나면 다시 볼 수 없으니 바로 복사해서 저장해두세요.

2. SourceTree에 토큰 적용

Sourcetree로 들어와서 설정을 열어줍니다.

원격 -> 원격 저장소 경로에서 토큰을 적용할 경로를 더블 클릭합니다.

URL / 경로에 git repository URL이 들어있습니다.

발급 받았던 토큰을 아래 예시와 같이 넣으면 됩니다. (토큰@ 을 추가하면 됩니다)

https://토큰@github.com/xxx/project.git

토큰 적용을 완료하셨다면 위 오류가 해결될 수 있습니다.

📜 오류 발생

vercel에 연동된 Next.js 프로젝트에 postgres를 연동하던중 아래와 같은 오류가 발생하였다.

Error while fetching side menu data: VercelPostgresError: VercelPostgresError - 'missing_connection_string': You did not supply a 'connectionString' and no 'POSTGRES_URL' env var was found.

오류상으로는 'connectionString', 'POSTGRES_URL'에 대해서만 나와서 다른 문제라고는 생각하지 못했는데

생각보다 간단한 문제로 나던 오류였다.

💊 해결 방법

postgres 데이터를 직접 불러오는 파일이 클라이언트 컴포넌트 상태라서 생기는 문제였다.

'use server'를 파일 상단에 입력하여 서버 컴포넌트로 변경시키는 것으로 간단하게 해결되었다.

'use server'

import { sql } from "@vercel/postgres";

interface MenuItem {
  id: number;
  name: string;
  description: string;
  link: string;
  sub_menus: SubMenuItem[];
}

interface SubMenuItem {
  id: number;
  name: string;
  description: string;
  link: string;
}

export async function getSideMenuData(): Promise<MenuItem[]> {
    try {
      const { rows }: { rows: MenuItem[] } = await sql`SELECT
        m.id AS id,
        m.name AS name,
        m.description AS description,
        m.link AS link,
        COALESCE(json_agg(json_build_object('id', sub.id, 'name', sub.name, 'description', sub.description, 'link', sub.link)) FILTER (WHERE sub.id IS NOT NULL), '[]') AS sub_menus
        FROM
        side_menu AS m
        LEFT JOIN
        side_menu AS sub ON m.id = sub.parent_id
        WHERE
        m.parent_id IS NULL
        GROUP BY
        m.id;
      `;
      return rows;
    } catch (error) {
      throw new Error('Failed to fetch side menu data');
    }
  }

📜 오류 발생

기존의 JavaScript 기반의 Next.js 프로젝트에 Typescript를 적용하던중 아래와 같은 오류가 발생하였다.

cannot use jsx unless the '--jsx' flag is provided

문제를 해결하기 위해 검색하던 중 VS Code에서Typescript 버전을 변경하면 해결된다는 자료들을 발견하였다.

F1 -> Typescript: Select TypeScript Version... 클릭

Use Workspace Version 클릭

Workspace Version으로 변경후 문제는 해결되었는데 VS Code's Version과 어떤 차이가 있길래 문제가 발생했는지 찾아보았다.

https://code.visualstudio.com/docs/typescript/typescript-compiling#_using-newer-typescript-versions

간단하게 요약하자면, 공식 문서에서 이야기하는 바는 아래와 같다. (초월 번역 했습니다)

VS Code는 자체적으로 최신 버전의 TypeScript가 기본으로 제공되는데, 이는 작업 파일을 컴파일하는 데 사용하는 TypeScript 버전과 별개이다. 일반적으로는 VS Code에서 기본으로 제공하는 TypeScript 버전을 사용할 수 있지만 문제가 생기면 작업 파일 버전으로 변경해야 할 수도 있다. (변경 방법은 위에 설명드린 내용과 같습니다)

📜 오류 발생

App Router 형식으로 되어있는 프로젝트에서 useRouter를 사용하는 도중에 아래와 같은 오류가 발생하였다.

Error: NextRouter was not mounted. https://nextjs.org/docs/messages/next-router-not-mounted

에러 메세지에 달려있는 공식문서 링크를 확인해보니 App Router를 사용중이라면 next/navigation 를 통해 import를 하면 된다고 안내하고있다. 오류가 난 시점에는 next/router 로 import 중이었기 때문에 오류가 나는 문제는 해결되었다.

If used in the app directory, migrate to the new hooks imported from next/navigation.

다만 나는 네비바에서 현재 위치한 페이지를 활성화 시켜서 보여주기 위해 현재 페이지 경로값이 필요했는데 next/navigation 로 불러온 useRouter에서는 현재 경로값을 찾기 어려웠다.

그래서 공식문서를 더 찾아보니 next/navigation 에서 usePathname으로 경로값을 받아와서 링크 활성상태를 비교하는것을 권장하고 있었다.

https://nextjs.org/docs/app/building-your-application/routing/linking-and-navigating

'use client'
import Link from "next/link";
import { usePathname } from 'next/navigation';
// import linkData from ...;

const Sidebar = () => {
  const pathName = usePathname();

  return (
    <nav>
      {linkData.map((link) => (
          <Link
            key={link.href}
            href={link.href}
            className={pathName === link.href ? "active" : "common"}
          >
            {link.label}
          </Link>
      ))}
    </nav>
  );
};

export default Sidebar;

usePathname을 사용하여, 현재 페이지 경로값과 일치하는 Link 태그에 활성화 표시를 할 수 있게 되었다.