在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第一公里的关键所在。
