使用Python的MT5Manager创建MT5用户账户失败问题排查

问题描述 #

成功连接MT5服务器后，调用UserAdd返回False，但代码误判为创建成功，随后无法在用户列表中找到目标用户。

原代码 #

import logging
from MT5Manager import ManagerAPI
import time

# Logging setup
logging.basicConfig(level=logging.DEBUG, format="%(asctime)s - %(levelname)s - %(message)s")
logger = logging.getLogger(__name__)

MT5_SERVER_ADDRESS = "***"
MT5_LOGIN_ID = 1011
MT5_PASSWORD = "***"

def connect_to_mt5():
    """Connect to the MT5 server with detailed debugging."""
    manager = ManagerAPI()
    try:
        logger.info("Attempting to connect to the MT5 server...")
        response = manager.Connect(MT5_SERVER_ADDRESS, MT5_LOGIN_ID, MT5_PASSWORD, 2, 1000000)
        if response:
            logger.info("Successfully connected to the MT5 server.")
            return manager
        else:
            logger.error("Failed to connect to the MT5 server. Raw response: %s", response)
            return None
    except Exception as e:
        logger.exception("Exception occurred during connection to the MT5 server.")
        return None

def add_user(manager, pass_main, pass_investor, group, **kwargs):
    """Create a user account on the MT5 server with minimal data."""
    try:
        logger.info("Preparing user creation request...")
        user_request = {
            "pass_main": pass_main,  # Main password
            "pass_investor": pass_investor,  # Investor password
            "group": group,  # Group name
            "name": kwargs.get("name", "Propiy"),  # Optional name
            "city": kwargs.get("city", "website"),  # Optional city
            "state": kwargs.get("state", "website"),  # Optional state
            "country": kwargs.get("country", "website"),  # Optional country
            "zipcode": kwargs.get("zipcode", "1470"),  # Optional zipcode
        }

        logger.debug("User request data: %s", user_request)
        logger.info("Sending user creation request to the MT5 server...")
        result = manager.UserAdd(user_request)
        logger.debug(f"Raw UserAdd response: {result}")

        if result == 0:
            logger.info("User creation request succeeded.")
            # Retrieve and inspect all users
            logins = manager.UserLogins()
            if logins:
                logger.info("Retrieved logins: %s", logins)
                for login in logins:
                    user_details = manager.UserGet({"Login": login})
                    logger.debug(f"Retrieved user details: {user_details}")
                    # Match user details
                    if user_details and user_details.get("Name") == user_request["name"]:
                        logger.info(f"Successfully located created user with Login ID: {user_details['Login']}")
                        return user_details["Login"]
            logger.error("Failed to locate the created user in the retrieved list.")
        else:
            logger.error(f"User creation failed. Server returned: {result}")
            return None
    except Exception as e:
        logger.exception("Exception occurred during user creation.")
        return None

if __name__ == "__main__":
    try:
        logger.info("Starting the MT5 user creation script...")
        manager = connect_to_mt5()

        if manager:
            # Add a delay to ensure the server has stabilized between connections
            time.sleep(2)

            # Minimal user info for testing
            pass_main = "Test123!"
            pass_investor = "forex-hedge"
            group = "1"  # Replace with the target group

            # Attempt to create the user
            login_id = add_user(manager, pass_main, pass_investor, group)

            if login_id:
                logger.info(f"User created successfully with Login ID: {login_id}")
            else:
                logger.error("Failed to create the user.")

            # Disconnect from the server
            logger.info("Disconnecting from the MT5 server...")
            manager.Disconnect()
            logger.info("Disconnected successfully.")
        else:
            logger.error("Could not establish a connection to the MT5 server.")
    except Exception as main_exception:
        logger.exception("An unexpected error occurred during execution.")

执行日志 #

2024-11-18 15:44:10,428 - INFO - Starting the MT5 user creation script...
2024-11-18 15:44:10,451 - INFO - Attempting to connect to the MT5 server...
2024-11-18 15:44:10,583 - INFO - Successfully connected to the MT5 server.
2024-11-18 15:44:12,584 - INFO - Preparing user creation request...
2024-11-18 15:44:12,584 - DEBUG - User request data: {'pass_main': 'Test123!', 'pass_investor': 'forex-hedge', 'group': '1', 'name': 'Propiy', 'city': 'website', 'state': 'website', 'country': 'website', 'zipcode': '1470'}
2024-11-18 15:44:12,584 - INFO - Sending user creation request to the MT5 server...
2024-11-18 15:44:12,584 - DEBUG - Raw UserAdd response: False
2024-11-18 15:44:12,584 - INFO - User creation request succeeded.
2024-11-18 15:44:12,584 - ERROR - Failed to locate the created user in the retrieved list.
2024-11-18 15:44:12,585 - ERROR - Failed to create the user.
2024-11-18 15:44:12,585 - INFO - Disconnecting from the MT5 server...
2024-11-18 15:44:12,594 - INFO - Disconnected successfully.

问题分析 #

1. 返回值判断逻辑错误：原代码认为result == 0是成功，但MT5 Manager API的UserAdd方法成功时返回新用户的Login ID（正整数），失败时返回False或负数错误码。原判断条件完全颠倒，导致把失败当成成功。
2. 缺少错误详情获取：没有调用manager.LastError()获取服务器返回的具体错误原因，无法排查参数缺失、权限不足等问题。
3. 用户定位逻辑低效且不可靠：遍历所有用户用Name匹配，既浪费资源又容易因为重名找不到目标用户；成功创建后直接用返回的Login ID查询即可。
4. 必填参数可能缺失：MT5创建用户需要leverage（杠杆）、currency（账户货币）等必填字段，且group参数格式需符合服务器配置（比如"demo\standard"，而非单纯的"1"）。

修正后的代码 #

import logging
from MT5Manager import ManagerAPI
import time

# Logging setup
logging.basicConfig(level=logging.DEBUG, format="%(asctime)s - %(levelname)s - %(message)s")
logger = logging.getLogger(__name__)

MT5_SERVER_ADDRESS = "***"
MT5_LOGIN_ID = 1011
MT5_PASSWORD = "***"

def connect_to_mt5():
    """Connect to the MT5 server with detailed debugging."""
    manager = ManagerAPI()
    try:
        logger.info("Attempting to connect to the MT5 server...")
        response = manager.Connect(MT5_SERVER_ADDRESS, MT5_LOGIN_ID, MT5_PASSWORD, 2, 1000000)
        if response:
            logger.info("Successfully connected to the MT5 server.")
            return manager
        else:
            logger.error("Failed to connect to the MT5 server. Error: %s", manager.LastError())
            return None
    except Exception as e:
        logger.exception("Exception occurred during connection to the MT5 server.")
        return None

def add_user(manager, pass_main, pass_investor, group, **kwargs):
    """Create a user account on the MT5 server with required fields."""
    try:
        logger.info("Preparing user creation request...")
        # 补充MT5必填字段，根据服务器配置调整
        user_request = {
            "pass_main": pass_main,
            "pass_investor": pass_investor,
            "group": group,
            "name": kwargs.get("name", "Propiy"),
            "city": kwargs.get("city", "website"),
            "state": kwargs.get("state", "website"),
            "country": kwargs.get("country", "US"),  # 使用有效国家代码
            "zipcode": kwargs.get("zipcode", "1470"),
            "leverage": kwargs.get("leverage", 100),  # 必填：杠杆比例
            "currency": kwargs.get("currency", "USD"),  # 必填：账户货币
            "email": kwargs.get("email", "test@example.com")  # 部分服务器要求邮箱
        }

        logger.debug("User request data: %s", user_request)
        logger.info("Sending user creation request to the MT5 server...")
        new_login = manager.UserAdd(user_request)
        logger.debug(f"Raw UserAdd response: {new_login}")

        # 正确判断：返回正整数表示成功，False/负数表示失败
        if isinstance(new_login, int) and new_login > 0:
            logger.info(f"User creation succeeded. New Login ID: {new_login}")
            # 直接用返回的Login ID查询用户详情
            user_details = manager.UserGet({"Login": new_login})
            if user_details:
                logger.debug(f"Created user details: {user_details}")
            return new_login
        else:
            # 获取具体错误信息
            error_msg = manager.LastError()
            logger.error(f"User creation failed. Server error: {error_msg}, Raw response: {new_login}")
            return None
    except Exception as e:
        logger.exception("Exception occurred during user creation.")
        return None

if __name__ == "__main__":
    try:
        logger.info("Starting the MT5 user creation script...")
        manager = connect_to_mt5()

        if manager:
            # 替换为服务器存在的有效组名，比如"demo\standard"
            pass_main = "Test123!"
            pass_investor = "forex-hedge"
            group = "demo\\standard"  # 注意转义反斜杠

            login_id = add_user(manager, pass_main, pass_investor, group)

            if login_id:
                logger.info(f"User created successfully with Login ID: {login_id}")
            else:
                logger.error("Failed to create the user.")

            logger.info("Disconnecting from the MT5 server...")
            manager.Disconnect()
            logger.info("Disconnected successfully.")
        else:
            logger.error("Could not establish a connection to the MT5 server.")
    except Exception as main_exception:
        logger.exception("An unexpected error occurred during execution.")

关键修改点 #

• 修正返回值判断：检查new_login是否为正整数，而非判断是否等于0。
• 添加错误详情获取：调用manager.LastError()获取服务器具体错误信息，便于排查问题。
• 补充必填字段：添加leverage、currency等MT5创建用户的必填参数，确保请求合法。
• 优化用户定位：创建成功后直接用返回的Login ID查询用户，无需遍历全部用户。
• 修正group参数格式：使用符合服务器配置的组名格式，避免无效参数导致失败。

内容的提问来源于stack exchange，提问作者Omid Goudazi