我刚看了你的测试代码和问题描述，独立运行正常但单元测试出问题，这种情况大多和测试环境下的事件循环、异步操作时序有关，我帮你梳理几个关键问题点和解决办法：

问题背景 #

你正在用C++/Qt开发客户端-服务端JsonRPC库，独立程序功能正常，但使用Qt单元测试框架时遇到：

• 客户端偶尔无法连接服务器
• 连接成功后发送的数据为空

测试代码如下：

class JsonRPCServerTest : public QObject { 
    Q_OBJECT 
public: 
    JsonRPCServerTest(QObject* parent = nullptr); 
    ~JsonRPCServerTest(); 
private Q_SLOTS: 
    void initTestCase(); 
    void client(); 
    void cleanupTestCase(); 
private : 
    JsonRPCClient m_client; 
}; 

JsonRPCServerTest::JsonRPCServerTest(QObject* parent): QObject(parent) { } 

void JsonRPCServerTest::client() { 
    m_client.setUrl(QUrl("http://127.0.0.1:8383")); 
    int i = 1; 
    QJsonObject jobj; 
    jobj["x"] = i; 
    jobj["y"] = i; 
    JsonRPCRequest req(1, "sum", jobj); 
    qDebug() << "Dispatching " << req.data(); 
    m_client.dispatch(req); 
    qApp->processEvents(); 
} 

QTEST_GUILESS_MAIN(JsonRPCServerTest) 
#include "tst_jsonrpcserver.moc"

排查与解决步骤 #

1. 服务器启动时序问题：未等待服务器就绪 #

你的initTestCase()看起来是空实现？如果服务器是在测试流程中启动的，或者依赖外部启动的服务器，测试代码直接调用client()去连接，很可能服务器还没完成端口监听、初始化，导致连接失败。

解决办法：

• 在initTestCase()中添加服务器启动逻辑，并等待服务器完全就绪：
  • 如果是测试代码内启动服务器，监听server->isListening()状态，或者等待server->newConnection()信号（如果是TCP服务器）
  • 如果是外部服务器，用QTcpSocket做预连接检查，循环尝试直到连接成功或超时（比如最多尝试5次，每次间隔500ms）

2. 事件循环处理不充分：单次processEvents()不足以完成异步操作 #

qApp->processEvents()只会处理当前事件队列中的事件，但网络连接、数据发送都是异步操作，单次调用可能还没等连接建立、数据写入socket，测试函数就执行完毕了，自然会出现连接失败或发送空数据的情况。

改进代码：
改用QEventLoop等待关键信号，确保操作完成，同时添加超时避免无限等待：

void JsonRPCServerTest::client() { 
    // 重置客户端状态，避免之前的测试影响
    m_client.disconnectFromHost();
    m_client.setUrl(QUrl("http://127.0.0.1:8383")); 

    int i = 1; 
    QJsonObject jobj; 
    jobj["x"] = i; 
    jobj["y"] = i; 
    JsonRPCRequest req(1, "sum", jobj); 
    qDebug() << "Dispatching " << req.data(); 

    QEventLoop loop;
    QTimer timeoutTimer;
    timeoutTimer.setSingleShot(true);

    // 假设你的JsonRPCClient有requestSent信号，标记请求已成功发送
    connect(&m_client, &JsonRPCClient::requestSent, &loop, &QEventLoop::quit);
    // 3秒超时，防止测试卡住
    connect(&timeoutTimer, &QTimer::timeout, &loop, &QEventLoop::quit);

    timeoutTimer.start(3000);
    m_client.dispatch(req);
    loop.exec(); // 等待发送完成或超时

    // 这里可以添加断言，比如检查客户端是否处于连接状态，或者验证发送的数据
    QVERIFY(m_client.isConnected());
}

3. 客户端实例状态未重置：成员变量的复用问题 #

m_client是类成员变量，如果测试多次运行（比如你后续添加其他测试用例），前一次测试的连接状态、错误状态可能会影响下一次测试，导致连接异常。

解决建议：

• 在initTestCase()中初始化客户端，或者在每个测试函数开始前重置客户端状态（比如调用disconnectFromHost()、清空缓存）
• 也可以把m_client改成client()函数的局部变量，确保每次测试都使用全新的客户端实例

4. 异步发送的序列化验证：确认数据在测试环境下正确生成 #

虽然独立运行正常，但要检查JsonRPCRequest::data()在测试环境下是否正确序列化。比如有没有在测试模式下禁用某些序列化逻辑，或者编码问题导致数据为空。

验证方式：
在dispatch()前打印req.data()的原始字节流，而不是只打印QJsonObject：

QJsonDocument doc(req.data());
qDebug() << "Serialized data:" << doc.toJson(QJsonDocument::Compact);

确认输出的JSON字符串是完整的，没有为空的情况。

额外建议 #

• 在cleanupTestCase()中记得关闭服务器和客户端的连接，释放资源，避免影响后续测试
• 如果是HTTP-based的JsonRPC，检查客户端是否正确处理了HTTP请求的头信息（比如Content-Type是否设置为application/json），测试环境下可能默认头缺失导致服务器无法解析数据

内容的提问来源于stack exchange，提问作者Roya Ghasemzadeh