[macOS] zsh: command not found: mysql 해결 방법

Mac에서 Homebrew를 사용하여 MySQL을 설치했지만 zsh: command not found: mysql 오류가 발생하는 경우, 다음 단계를 따라 문제를 해결해보세요

homebrew 를 이용하여 mysql 을 설치하고 나면 아래와 같이 path 를 추가하라는 문구가 뜹니다.

If you need to have mysql@5.7 first in your PATH, run:
  echo 'export PATH="/usr/local/opt/mysql@5.7/bin:$PATH"' >> ~/.zshrc

위 문구대로 echo ~ 끝까지 복사해서 붙여넣고 실행하고
버전을 확인하기 위해서 mysql --version 를 실행하면 명령어를 찾을 수 없다는 문구가 나옵니다.
zshrc 를 수정하고 동작하게 실행을 안해줘서 그런 부분입니다.

MySQL 설치 확인

먼저 Homebrew를 사용하여 MySQL이 정상적으로 설치되어 있는지 확인합니다.

brew list | grep mysql

위 명령어를 실행했을 때 mysql 관련 내용이 출력되면 설치는 정상적으로 되어 있는 것입니다.

PATH 설정 확인

Homebrew를 사용하여 설치된 MySQL의 실행 파일 경로가 PATH에 포함되어 있는지 확인합니다.
터미널에서 echo $PATH를 실행하여 현재 PATH를 출력합니다.
만약 /usr/local/opt/mysql/bin 또는 해당 버전의 경로가 포함되어 있지 않다면, ~/.zshrc 파일에 아래 내용을 추가해야 합니다.

export PATH="/usr/local/opt/mysql/bin:$PATH"

변경사항 적용

~/.zshrc 파일을 수정한 후에는 아래 명령어를 터미널에서 실행하여 변경사항을 적용합니다.

source ~/.zshrc

MySQL 서비스 시작

MySQL 서비스가 아직 시작되지 않았다면, 서비스를 시작합니다. (이는 명령어를 찾지 못하는 문제와는 직접적으로 관련이 없지만, MySQL을 사용하려면 필요한 단계입니다.)

brew services start mysql

이 단계들을 수행한 후에도 여전히 문제가 해결되지 않는다면, 추가적인 설정이나 문제의 원인을 파악하기 위해 다양한 정보와 설정을 확인해야 할 수 있습니다.