IB API 连接失败的常见原因及正确调用方式详解

在IB API的调试过程中，504 Not Connected这个错误提示，可以说是不少初学者的一块“心病”。明明TWS（Trader Workstation）的「Data Connections」表格里已经显示状态为Accepted，控制台却毫不留情地抛出ERROR -1 504 Not connected。这并非网络问题，也不是权限配置出了岔子——问题往往出在代码里一个极容易被忽略的细节上：app.run是一个方法，它必须被显式调用，也就是加上括号。

你提供的示例代码，最后一行写的是app.run。这仅仅是对该方法的引用，并未真正触发事件循环。程序自然会在执行完这一行后立即退出，API连接随之中断，请求自然无法送达。修正后的、可正常运行的完整示例代码是这样的：

from ibapi.client import EClient
from ibapi.wrapper import EWrapper
from ibapi.contract import Contract
import time

class TestApp(EClient, EWrapper):
    def __init__(self):
        EClient.__init__(self, self)

    def error(self, reqId, errorCode, errorString, advancedOrderReject):
        print(f"Error {errorCode}: {errorString}")

    def contractDetails(self, reqId, contractDetails):
        print(f"Contract details: {contractDetails}")

    def contractDetailsEnd(self, reqId):
        print("End of contract details")
        self.disconnect()

def main():
    app = TestApp()
    app.connect("127.0.0.1", 7497, clientID=1)  # 端口、IP、clientID必须与TWS设置严格一致

    # 启动连接后需等待回调确认（非阻塞，但需留出握手时间）
    time.sleep(1)

    # 构建合约
    mycontract = Contract()
    mycontract.symbol = "AAPL"
    mycontract.secType = "STK"
    mycontract.exchange = "SMART"
    mycontract.currency = "USD"
    mycontract.primaryExchange = "ISLAND"

    # 发起请求
    app.reqContractDetails(1, mycontract)

    # ⚠️ 关键修正：必须加括号启动事件循环！
    app.run()  # ← 此处是核心修复点

if __name__ == "__main__":
    main()

那么，在实际操作中，有哪些细节需要特别留意？

首先，app.run() 后面的括号绝不可省略。这是启动IB API事件循环的唯一入口，缺了括号等于“声明但不执行”，连接瞬间就会断开。其次，不要依赖time.sleep()来确认连接状态。sleep(3)并不靠谱，更稳健的做法是重写nextValidId或connectionClosed这些回调，实现真正的状态感知。最后，再检查一遍TWS的配置，即使它已经显示“Accepted”：

• 是否启用了API：Configure → API → Settings → Enable ActiveX and Socket Clients
• 端口是否一致：Socket port默认7497（模拟账户为7498），必须与app.connect()中的参数完全匹配
• 客户端ID是否匹配：TWS中Settings → API → Client ID必须等于代码中connect(..., clientId=1)的设定值
• 是否勾选了“Allow connections from localhost only”：这个选项通常已隐含了本地信任，无需额外填写127.0.0.1到白名单

调试时，建议在代码中启用EWrapper.error()回调——就像上面示例中做的那样。它能捕获底层连接异常，远比静默失败更有诊断价值。

回到开头的问题：504 Not Connected这个错误，其实绝大多数情况下都不是环境或配置问题，而是API生命周期管理上出现了偏差。记住，app.run()是启动引擎的“点火开关”，而不是一个静态属性——补上那一对括号，往往就是打通IB API第一公里的关键所在。