에러코드별 문제해결하기
미니톡 클라이언트 및 미니톡 채팅위젯에서는 몇가지 에러에 대하여 에러코드를 발생시키고 있습니다.
이 문서에는 각 에러코드별 원인 및 해결방법에 대하여 설명합니다.
에러코드 100번대
에러코드 100번대는 사용자 닉네임과 관련된 에러를 의미합니다.
에러코드 | 원인 및 해결방법 |
100 | 닉네임에 허용되지 않는 문자가 포함되어 있거나, 닉네임의 최대허용길이를 초과합니다. 닉네임에는 일부특수문자(#, @, ", ')및 공백이 허용되지 않으며, 닉네임의 최대길이는 30자까지만 지원합니다. 유저코드생성시 위의 규칙을 만족하는 닉네임으로 설정된 유저코드를 생성 후 사용해보시기 바랍니다. |
101 | 닉네임이 중복된 경우 발생합니다. 기존에 중복된 닉네임으로 접속된 사용자의 접속이 끊어지게 되며, 이는 정상동작범위입니다. |
102 | 닉네임이 중복된 경우 발생합니다. 기존에 중복된 닉네임으로 접속된 사용자의 접속이 해제되면 자동으로 재접속하게 됩니다. |
103 | 닉네임 변경이 허용되지 않는 채널에서 닉네임 변경을 시도할 때 발생합니다. |
104 | 이미 사용중인 닉네임으로 변경을 시도하는 경우 발생합니다. |
에러코드 400번대
에러코드 400번대는 권한문제 및 요청된 데이터에 오류가 있을 경우 발생합니다.
에러코드 | 원인 및 해결방법 |
403 | 특정 요청에 대한 권한이 없을 경우 발생합니다. 채널설정 등에 설정된 권한을 다시 한번 확인해보시고, 권한이 있는 레벨의 유저코드를 사용하고 있는지 확인해보시기 바랍니다. |
404 | 특정 요청에 대한 대상 데이터가 없을 경우 발생합니다. 잠시후 다시 시도하거나, 요청하는 대상(닉네임 대상, 호출대상 등)이 존재하는지 다시 확인해보시기 바랍니다. |
410 | 이미 채널관리자 권한을 가진 상태에서 채널 관리자 권한을 획득하려고 할 때 발생합니다. |
411 | 채널설정에 설정된 채널 패스워드가 일치하지 않는 경우입니다. |
412 | 유저코드를 통해 이미 채널 관리자권한을 획득한 경우 /logout 명령으로 채널관리자 권한을 해지할 수 없습니다. |
에러코드 800번대
에러코드 800번대는 개인박스와 관련된 오류가 있을 경우 발생합니다.
에러코드 | 원인 및 해결방법 |
800 | 개인박스를 개설하는 동안 오류가 발생한 경우로 대부분의 경우 다시 개인박스개설을 시도할 경우 문제없이 개설이 됩니다. |
801 | 비공개 개인박스(패스워드가 설정된 개인박스)에 패스워드 없이 접속을 시도하는 경우 발생합니다. |
802 | 비공개 개인박스(패스워드가 설정된 개인박스)에 패스워드가 일치하지 않는 경우 발생합니다. |
803 | 개인박스를 개설할 권한이 없음에도 개인박스를 개설하고자 시도할 때 발생합니다. 개인박스 개설권한은 미니톡 클라이언트 관리자 채널관리에서 설정할 수 있습니다. |
804 | 존재하지 않는 개인박스에 접속을 시도할 때 발생합니다. 개인박스 개설자가 접속을 종료하여 개인박스가 존재하지 않을 경우 발생할 수 있습니다. |
899 | 개인박스에 접속하고 있던 도중 개인박스를 개설한 사용자가 접속을 중단하였을 경우, 해당 개인박스가 종료되며 접속중인 모든 유저의 접속이 종료될 때 발생합니다. |
에러코드 900번대
에러코드 900번대는 서버 접속과 관련된 오류가 있을 경우 발생합니다.
에러코드 | 원인 및 해결방법 |
900 | 서버접속에 필요한 필수정보가 누락되었을 경우 발생합니다. 미니톡 클라이언트를 수정하지 않았다면 발생하지 않는 문제로, 미니톡 클라이언트를 수정하였다면, 원래 배포된 파일로 복구 후 시도해보시기 바랍니다. |
901 | 서버접속에 필요하지 않은 불필요한 데이터와 함께 서버접속을 시도할 경우 발생합니다. 서버접속시 특정 데이터를 함께 전달하고자 하는 경우에는 유저코드생성시 $extras=array() 값에 해당 정보를 설정하시기 바랍니다. 그 외의 방법으로 추가 데이터가 전달되는 경우 접속이 차단됩니다. |
902 | 서버접속코드를 확인할 수 없는 경우 발생합니다. 일반적인 경우에는 발생하지 않으며 미니톡 클라이언트를 수정하였다면 원래 배포된 파일로 복구 후 시도해보시기 바랍니다. 미니톡 클라이언트 설치시 생성되는 /configs/key.config.php 파일을 임의로 수정하신 경우 미니톡 클라이언트를 재설치한 뒤 시도해보시기 바랍니다. |
903 | 서버접속코드가 만료된 경우 발생합니다. 채팅호스팅 서비스를 받고 있는 경우에 간헐적으로 발생할 수 있으며, 채팅호스팅 연결이 불완전할 때 발생할 수 있습니다. 채팅호스팅 서비스 매뉴얼을 참고하여 미니톡 클라이언트 관리자에서 채팅호스팅 연결을 다시 확인하신 후 시도해보시기 바랍니다. |
904 | 채널접속코드를 확인할 수 없을 때 발생합니다. 일반적인 경우에는 발생하지 않으며 미니톡 클라이언트를 수정하였다면 원래 배포된 파일로 복구 후 시도해보시기 바랍니다. 미니톡 클라이언트 설치시 생성되는 /configs/key.config.php 파일을 임의로 수정하신 경우 미니톡 클라이언트를 재설치한 뒤 시도해보시기 바랍니다. |
910 | 유저접속코드를 확인할 수 없을 때 발생합니다. 유저코드생성시 미니톡 클라이언트 설치시 입력한 암호화키가 아닌 다른 문자열로 유저코드가 생성되었거나, 유저코드생성함수가 잘못된 경우 발생합니다. 유저코드생성하는 매뉴얼을 참고하여 정상적인 방법으로 유저코드를 생성 후 시도해보시기 바랍니다. |
911 | 유저의 IP를 확인할 수 없는 경우 발생합니다. 유저코드 생성시 미니톡 클라이언트가 설치된 웹서버에서 파악한 유저의 IP 정보가 포함됩니다. 해당 IP정보와 미니톡 서버에 접속하는 유저의 IP가 다른경우 발생합니다. 미니톡 서버는 IPv4 만을 지원하며, 웹서버가 IPv6 를 지원할 경우 유저코드에 포함된 IP가 IPv6 로 기록되어 발생할 수 있습니다. 필수적으로 IPv6 가 필요한 경우가 아닌경우, 웹서버의 IPv6 지원을 끄고 IPv4 만 지원하도록 설정함으로써 해결할 수 있습니다. 또는 클라우드플레어나 L4 장비등과 같이 미니톡 클라이언트가 설치된 웹서버에서 유저의 실제 IP 가 아닌, 클라우드플레어 IP 또는 L4 장비의 IP가 유저코드에 기록되는 경우에도 발생할 수 있습니다. 미니톡 클라이언트의 /classes/functions.php 파일내에 GetClientIp() 함수가 존재하는데, 이 함수의 리턴값이 유저의 실제 IP인지 확인해보시기 바랍니다. 유저의 실제 IP 가 아닌 다른 IP가 출력된다면, 사용하시는 웹서버에서 유저의 실제 IP를 확인할 수 있는 변수($_SERVER['HTTP_X_FORWARDED_FOR'] 등) 을 이용하여 유저의 실제 IP 가 유저코드에 기록될 수 있도록 수정하여 주시기 바랍니다. |
912 | 생성된 유저코드내에 포함된 유저데이터 중 누락된 데이터가 있는 경우 발생합니다. 유저코드에는 nickname, nickcon, photo, level, extras, ip 값이 필수적으로 존재하여야 합니다. 유저코드 생성방법에 대한 매뉴얼을 확인하신 후 정상적인 유저코드를 생성하여 시도해보시기 바랍니다. |
913 | 유저데이터에 nickname, nickcon, photo, level, extras, ip 값 외에 다른 데이터가 존재할 경우 발생합니다. 유저데이터에 추가적인 데이터를 기록해야하는 경우 extras 값에만 추가할 수 있으며, 다른 방법으로 추가된 데이터가 존재할 경우 서버접속이 차단됩니다. |
914 | 유저닉네임이 잘못 정의된 경우 발생합니다. CODE 100 에 설명된 닉네임 규칙에 따라 닉네임을 설정하신 후 생성된 유저코드로 접속을 시도해보시기 바랍니다. |
915 | 유저코드생성시 닉네임에 NULL 을 입력하여 닉네임이 정의되지 않은 상태에서, 유저의 레벨을 1이상으로 설정하는 경우 발생합니다. 유저레벨을 1이상으로 설정하려면 반드시 고정된 닉네임이 필요합니다. |
916 | 유저코드생성시 닉네임에 NULL 이 아닌 고정된 닉네임을 설정하고, 유저레벨을 0으로 설정하는 경우 발생합니다. 고정닉네임이 존재하는 경우 유저레벨은 반드시 1레벨 이상으로 설정되어야 합니다. |
917 | 유저코드생성시 입력한 유저의 레벨이 허용범위(0~9)를 벗어날 경우 발생합니다. 웹사이트 상에서 회원의 권한레벨이 0~9 범위를 벗어날 경우, 웹사이트 상의 회원레벨을 미니톡 레벨범위(0~9)에 맞도록 적절하게 수정하여 주셔야 합니다. 예를 들어 관리자권한의 웹사이트 상의 회원레벨이 10 인 경우, 미니톡 관리자 레벨 9 로 수정하여 주셔야 합니다. |
918 | 유저코드 생성시 입력한 닉이미지 경로 또는 회원 프로필사진 경로가 문자열이 아닌 경우에 발생합니다. 해당부분에 적절한 이미지 URL 이 입력되었는지 확인해보시기 바랍니다. |
919 | 유저코드 생성시 입력한 유저의 추가정보가 배열 또는 객체가 아닌 경우 발생합니다. 유저의 추가정보는 배열 또는 객체로 정의되어야 합니다. |