如何在 Go 中发起 SOAP 请求-Golang-PHP中文网

如何在 Go 中发起 SOAP 请求

go 官方生态缺乏成熟的 soap 客户端库，但得益于其强大的标准 http 库和 xml 处理能力，手动构建轻量级 soap 请求层简洁高效，通常仅需百余行代码即可满足多数场景需求。

go 官方生态缺乏成熟的 soap 客户端库，但得益于其强大的标准 http 库和 xml 处理能力，手动构建轻量级 soap 请求层简洁高效，通常仅需百余行代码即可满足多数场景需求。

SOAP 协议本身是传输无关的 XML 消息规范（支持 HTTP、SMTP、TCP 等），其核心在于请求/响应体的 XML 结构（如 <envelope></envelope> 包裹的 <body></body>）。Go 的 net/http 和 encoding/xml 包已完全胜任底层通信与序列化任务——无需引入复杂第三方依赖，即可精准控制消息格式、头信息与错误处理。

以下是一个典型的 SOAP 1.1 请求示例（以调用天气 Web Service 为例）：

package main

import (
    "bytes"
    "encoding/xml"
    "fmt"
    "io"
    "net/http"
)

type WeatherRequest struct {
    XMLName xml.Name `xml:"http://tempuri.org/ GetWeather"`
    City    string   `xml:"City"`
}

type WeatherResponse struct {
    XMLName xml.Name `xml:"http://tempuri.org/ GetWeatherResponse"`
    Result  string   `xml:"GetWeatherResult"`
}

func callSOAPWeather(city string) (string, error) {
    // 构建 SOAP 请求体
    reqBody := struct {
        XMLName xml.Name `xml:"http://schemas.xmlsoap.org/soap/envelope/ Envelope"`
        Header  struct{} `xml:"Header"`
        Body    WeatherRequest `xml:"Body"`
    }{
        Body: WeatherRequest{City: city},
    }

    var buf bytes.Buffer
    enc := xml.NewEncoder(&buf)
    enc.Indent("", "  ")
    if err := enc.Encode(reqBody); err != nil {
        return "", fmt.Errorf("encode SOAP request: %w", err)
    }

    // 发起 HTTP POST 请求
    resp, err := http.Post(
        "https://example.com/weather.asmx",
        "text/xml; charset=utf-8",
        &buf,
    )
    if err != nil {
        return "", fmt.Errorf("HTTP request failed: %w", err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        return "", fmt.Errorf("SOAP server returned status %d", resp.StatusCode)
    }

    // 解析响应
    var soapResp struct {
        XMLName xml.Name `xml:"http://schemas.xmlsoap.org/soap/envelope/ Envelope"`
        Body    WeatherResponse `xml:"Body"`
    }
    if err := xml.NewDecoder(resp.Body).Decode(&soapResp); err != nil {
        return "", fmt.Errorf("decode SOAP response: %w", err)
    }

    return soapResp.Body.Result, nil
}

func main() {
    result, err := callSOAPWeather("Beijing")
    if err != nil {
        panic(err)
    }
    fmt.Println("Weather:", result)
}

✅ 关键优势：

完全可控：可自定义命名空间、SOAP Action 头（通过 req.Header.Set("SOAPAction", "...")）、超时、重试逻辑；
零依赖：仅使用 net/http 和 encoding/xml，无外部包兼容性风险；
轻量可维护：100–200 行代码即覆盖基础调用，便于单元测试与调试。

⚠️ 注意事项：

若服务端强制要求 WS-Security（如签名、加密、时间戳）、WSDL 自动生成客户端 或 XSD 类型校验，当前 Go 生态尚无成熟开源方案支持。此时建议：
- 优先协商改用 REST/JSON API；
- 或使用 gowsdl（实验性）等工具生成基础结构体，再手动补全安全逻辑；
- 极端场景下可考虑通过 os/exec 调用 curl + 预置 XML 模板（不推荐生产环境）。

? 总结：对于标准 SOAP 1.1/1.2 且无 WS-* 扩展的 Web Service，Go 原生能力足以优雅实现；与其等待“完美”第三方库，不如亲手编写专注、可测、透明的 SOAP 封装层——这正是 Go “少即是多”哲学的典型实践。