워드프레스 멀티사이트에서 로그인 문제 해결

로그인 오류 증상

• Bad gateway 502 오류 발생
• 로그인 실패
• 로그인 유지 안되며 자동 로그아웃
• 로그인 팝업 창, 세션 만료 창 나타남

로그인 오류 원인 및 해결

서브도메인 방식의 멀티사이트에서 쿠키 문제로 발생합니다.

wp-config.php 파일에서 아래와 같은 코드가 있다면 전부 삭제하거나 주석 처리해야 합니다.

//define('ADMIN_COOKIE_PATH', '/');
//define('COOKIEPATH', '/');
//define('SITECOOKIEPATH', '');

PATH 값이 ‘/’로 설정되어 있다면 하위 사이트 주소와 상관없이 쿠키를 공유하기 때문에 세션 충돌이 발생할 수 있습니다. 이는 하위 디렉터리 멀티사이트에서 사용됩니다.

wp-config.php 파일에서 아래와 같이 COOKIE_DOMAIN의 값을 설정합니다.

define('COOKIE_DOMAIN', $_SERVER['HTTP_HOST']);

사이트마다 각각의 쿠키 세션이 만들어집니다.

로그인 팝업 창이 나타날 때

로그인 상태에서 시간이 지나면 로그인을 하라는 팝업창이 나타날 수 있습니다. 실제로 로그아웃이 된 것은 아니며, 재로그인을 하지 않고 팝업을 닫거나 새로고침만으로 로그인 상태를 유지할 수 있습니다. 그래서 팝업창 자체를 띄울 필요가 없도록 아래 코드를 테마의 functions.php 파일에 추가하면 됩니다.

add_action( 'wp_print_scripts', function() {
    wp_dequeue_script( 'wp-auth-check' );
    wp_deregister_script( 'wp-auth-check' );
}, 999 );

마지막 줄의 숫자는 우선 순위가 낮음을 의미합니다. (WP 기본값은 10)

해당 내용은 WordPress 7.1 기준으로 작성되었습니다.