为何在wxThread中使用wxURL会触发SIGSEGV错误？

问题 #

编写的文件下载解压函数downloadAndExtractFile在主线程（wxFrame）中调用完全正常，但通过自定义wxThread子类BackgoundThread调用时，执行到wxURL::GetInputStream()会触发SIGSEGV错误。尝试改用wxHTTP、wxFileSystem实现下载，子线程调用时仍出现相同崩溃。

相关代码 #

下载解压函数

auto downloadAndExtractFile(const wxString& url) -> bool {
    // download file
    auto temp_file = wxFileName::CreateTempFileName("download_", (wxFile*)nullptr);
    auto dl = wxURL(url);
    
    auto err = dl.GetError();
    if (err == wxURL_NOERR) {
        wxInputStream *in = dl.GetInputStream();//SIGSEGV if func called from second thread
        if (in && in->IsOk()) {
            auto out = wxFFileOutputStream(temp_file);
            in->Read(out);
        } else {
            //TODO: log
            return false;
        }
        delete in;
    } else {
        //TODO: log
        return false;
    }
    
    // extract file
    wxExtractZipFiles(temp_file, wxFileName(temp_file).GetPath());
    //TODO: check?

    // delete downloaded file
    wxRemoveFile(temp_file);
    //TODO: check?

    return true;
}

自定义线程类

class BackgoundThread: public wxThread {
private:    // helpers
protected:  // helpers
public:     // helpers
//------------------------------------------------------------------------------
private:    // member fields
    wxFrame     *m_parent_{nullptr};
    wxString    m_selected_filename_;
protected:  // member fields
public:     // member fields
//------------------------------------------------------------------------------
private:    // member inline getter/setter/toggle
protected:  // member inline getter/setter/toggle
public:     // member inline getter/setter/toggle
//------------------------------------------------------------------------------
private:    // member methods
protected:  // member methods
public:     // member methods
    auto Entry() -> ExitCode override {
        // disable start button
        wxCommandEvent event_disable_start_button(wxEVT_COMMAND_TEXT_UPDATED, BUTTON_START_DISABLE_ID);
        m_parent_->GetEventHandler()->AddPendingEvent(event_disable_start_button);
        
        auto time_in_seconds = [](long time_in_ms) -> float {
            return ((float)time_in_ms)/1000;
        };
        
        auto all_timer = wxStopWatch();
        
        // start download
        auto url_str = wxString("http://www.mattmahoney.net/dc/" + m_selected_filename_ + ".zip");
        wxCommandEvent event_download_started(wxEVT_COMMAND_TEXT_UPDATED, TEXT_CTRL_APPEND_TEXT_ID);
        event_download_started.SetString(wxString::Format("[.2f] Downloading/Extracting file: %s\n", time_in_seconds(all_timer.Time()), url_str));
        m_parent_->GetEventHandler()->AddPendingEvent(event_download_started);
        
        auto tempDir = wxFileName::GetTempDir();
        auto filePath = tempDir + wxFileName::GetPathSeparator() + m_selected_filename_;
        
        auto timer_download = wxStopWatch();
        downloadAndExtractFile(url_str);
        timer_download.Pause();
        wxCommandEvent event_download_ended(wxEVT_COMMAND_TEXT_UPDATED, TEXT_CTRL_APPEND_TEXT_ID);
        event_download_ended.SetString(wxString::Format("[.2f] download/extract done (%ld ms)\n", time_in_seconds(all_timer.Time()), timer_download.Time()));
        
        // enable start button
        wxCommandEvent event_enable_start_button(wxEVT_COMMAND_TEXT_UPDATED, BUTTON_START_ENABLE_ID);
        m_parent_->GetEventHandler()->AddPendingEvent(event_enable_start_button);
        
        return 0;
    }
//------------------------------------------------------------------------------
private:    // constructors/destructor
protected:  // constructors/destructor
public:     // constructors/destructor
    BackgoundThread(wxFrame *parent, wxString selected_filename = "enwik8", wxThreadKind kind = wxTHREAD_DETACHED): wxThread(kind), m_parent_(parent), m_selected_filename_(selected_filename) {}
};

其他尝试的实现

// wxHTTP版本
wxHTTP request;
request.Connect(url);
auto err = request.GetError();
if (err == wxPROTO_NOERR) {
    wxInputStream *in = request.GetInputStream(temp_file); //SIGSEGV if func called from second thread
    ...

// wxFileSystem版本
wxFileSystem fs;
fs.AddHandler(new wxInternetFSHandler());
wxFSFile *file = fs.OpenFile(url); //SIGSEGV if func called from second thread
...

调用栈信息 #

wxSocketFDBasedManager::Install_Callback(wxSocketImpl*, wxSocketNotify) 0x00000000004e006d
wxSocketImplUnix::DoEnableEvents(int, bool) 0x00000000004e01c3
wxSocketBase::SetFlags(int) 0x00000000004ddca9
wxSocketBase::Peek(void*, unsigned int) 0x00000000004de6ab
wxProtocol::ReadLine(wxSocketBase*, wxString&) 0x00000000004d8f2d
wxHTTP::BuildRequest(wxString const&, wxString const&) 0x00000000004d5f70
wxHTTP::GetInputStream(wxString const&) 0x00000000004d77d5
wxURL::GetInputStream() 0x00000000004ca5d3
downloadAndExtractFile main.cpp:89
BackgoundThread::Entry main.cpp:303
wxThread::CallEntry() 0x0000000000749632
wxThreadInternal::PthreadStart(wxThread*) 0x000000000074a03f
start_thread 0x00007f4adf51aea7
clone 0x00007f4adf44adef

问题原因与解决方案 #

原因分析 #

从调用栈可以看出，崩溃发生在wxSocketFDBasedManager::Install_Callback——wxWidgets的网络组件（wxURL、wxHTTP等）默认依赖GUI事件循环处理套接字的异步事件回调，而子线程没有运行GUI事件循环，导致套接字管理器尝试安装回调时找不到有效上下文，进而触发段错误。

解决方案 #

方案1：在子线程中使用阻塞式套接字模式

禁用套接字的异步事件通知，强制使用阻塞式操作，避免依赖主线程事件循环。修改downloadAndExtractFile函数，在创建网络对象前添加以下代码：

// 初始化子线程的套接字环境（确保只初始化一次）
if (!wxSocketBase::IsInitialized()) {
    wxSocketBase::Initialize();
}
// 设置全局套接字为阻塞模式，禁用异步事件
wxSocketBase::SetFlags(wxSOCKET_BLOCK);

如果使用wxHTTP，也可以单独设置实例模式：

wxHTTP request;
request.SetFlags(wxSOCKET_BLOCK); // 强制当前实例使用阻塞模式
request.Connect(url);

方案2：将下载任务委托给主线程事件循环

把下载操作放到主线程任务队列，通过wxPostEvent触发主线程执行下载，但这种方式会阻塞主线程，仅适合小文件场景，不推荐用于大文件下载。

额外注意事项 #

• 子线程结束时，若手动初始化了套接字环境，建议调用wxSocketBase::Shutdown()清理资源，但需确保无其他线程在使用套接字。
• wxExtractZipFiles为文件操作，本身线程安全，但子线程中禁止调用任何GUI相关API（如弹出对话框），所有UI更新必须通过AddPendingEvent委托给主线程处理。

内容的提问来源于stack exchange，提问作者B. A. Sylla