백그라운드에서 java 실행하기(java -jar vs nohup java -jar, feat. `cannot find symbol` 오류 해결)

1️⃣ cannot find symbol 오류 해결

이 오류는 주로 컴파일러가 필요한 클래스나 메서드를 찾지 못할 때 발생한다. 특히 메이븐(Maven)을 사용한 빌드 환경에서 자바 버전이 불일치할 때 자주 나타난다고 한다.

• Project Settings > Project > SDK 버전 확인
  

프로젝트에 맞는 버전으로 변경!

2️⃣ java -jar로 JAR 파일 실행하기

java -jar your-app.jar 명령어는 자바 애플리케이션을 실행하는 가장 기본적인 방법이다. 이 방식은 터미널에서 실행되며, 터미널 창을 닫거나 연결이 끊어지면 실행 중인 애플리케이션도 함께 종료된다. 따라서 개발 환경에서 일시적으로 테스트하거나 디버깅할 때 주로 사용된다.

3️⃣ nohup java -jar &로 JAR 파일 실행하기

nohup은 'no hang up' 의 약자로, 터미널 세션이 끊어져도 프로세스가 종료되지 않고 계속 실행되도록 하는 명령어이다. 서버 환경에서는 터미널 연결이 불안정하거나 실수로 종료될 수 있기 때문에, 서비스가 멈추지 않도록 nohup을 반드시 사용해야 한다.

nohup을 사용한 명령어는 아래와 같다.

nohup java -jar your-app.jar &

여기서 &는 프로세스를 백그라운드에서 실행하라는 의미이며 명령어 실행 후에도 터미널을 계속 사용할 수 있다.

4️⃣ JAR 파일 내부 프로퍼티 설정 값 확인하기

JAR 파일 생성 후 특정 파일이 적용되었는지나 프로퍼티 설정 값이 잘 들어갔는지 확인하고 싶을 때가 있다.
그럴 때는 아래 명령어를 사용하면 된다.

1) jar 내부 파일 목록 확인

jar -tf {JAR 파일명}

2) 내용 확인(파일명으로 안나오는 경우, 경로로 검색)

unzip -p {JAR 파일명} {파일명 또는 경로}

🎦 로그는 어디로 갈까? nohup.out

nohup으로 실행된 애플리케이션은 표준 출력(System.out)과 표준 에러(System.err)를 터미널에 표시하지 않는다. 대신, 이 모든 출력은 실행된 디렉터리에 nohup.out이라는 파일로 자동 저장된다. 이 파일을 통해 서버 애플리케이션의 동작 로그를 언제든지 확인할 수 있다.