本文旨在解决go语言中发送soap xml请求时遇到的http 401 unauthorized错误。我们将详细介绍如何利用`net/http`包的`setbasicauth`方法，通过http basic authentication机制在请求中携带凭据，从而成功访问需要认证的soap服务。教程将提供完整的代码示例和关键步骤解析，帮助开发者构建健壮的认证请求。
Go语言中实现HTTP Basic Auth的SOAP XML请求
在Go语言中与SOAP服务进行交互时，一个常见的问题是遇到HTTP 401 Unauthorized错误，这通常意味着请求没有提供有效的认证信息。对于大多数需要认证的HTTP服务，特别是那些使用HTTP Basic Authentication的服务，我们需要在请求中明确地设置认证头。本教程将详细阐述如何在Go语言中构建一个包含HTTP Basic Auth的SOAP XML请求。
1. 理解问题：为什么http.Post不足以应对认证？
在Go的标准库net/http中，http.Post函数是一个便捷的封装，用于发送POST请求。然而，它只接受URL、内容类型和请求体，并没有直接提供设置认证凭据的参数。当目标服务要求认证时，仅仅使用http.Post会导致请求被服务器拒绝，返回401状态码。
例如，原始代码中尝试直接使用http.Post：
r, _ := http.Post("http://mywebsite.com.br/service.svc?wsdl", "text/xml", body)这种方式无法在请求头中加入认证信息，因此无法通过需要认证的SOAP服务验证。
立即学习“go语言免费学习笔记（深入）”；
2. 解决方案：使用http.NewRequest和SetBasicAuth
为了在Go中发送带有HTTP Basic Authentication的请求，我们需要更细粒度地控制请求的构建过程。这包括以下几个关键步骤：
- 创建http.Request对象： 使用http.NewRequest函数创建一个请求对象。这允许我们设置请求方法（POST）、URL和请求体。
- 设置Basic Auth： 使用http.Request对象的SetBasicAuth(username, password string)方法。这个方法会自动计算并设置正确的Authorization HTTP头。
- 发送请求： 使用http.Client的Do(req *Request)方法发送构建好的请求。
3. 完整代码示例
下面是一个完整的Go程序，演示如何通过HTTP Basic Auth发送SOAP XML请求：
package main
import (
"bytes"
"fmt"
"io/ioutil"
"log"
"net/http"
)
func main() {
// 1. 定义SOAP XML请求体
soapXML := `
fc40a874-2902-4539-b8e7-6aa7084644ec
`
// 2. 将XML字符串转换为字节缓冲区
requestBody := bytes.NewBufferString(soapXML)
// 3. 定义目标URL、用户名和密码
url := "http://mywebsite.com.br/service.svc?wsdl" // 替换为你的SOAP服务URL
username := "your_username" // 替换为你的用户名
password := "your_password" // 替换为你的密码
// 4. 创建一个新的HTTP请求
req, err := http.NewRequest("POST", url, requestBody)
if err != nil {
log.Fatalf("创建请求失败: %v", err)
}
// 5. 设置HTTP Basic Authentication
req.SetBasicAuth(username, password)
// 6. 设置Content-Type头部，对于SOAP通常是text/xml
req.Header.Set("Content-Type", "text/xml")
// 根据SOAP版本，可能需要设置SOAPAction头，例如：
// req.Header.Set("SOAPAction", "http://tempuri.org/ClientGetByGuid")
// 7. 创建HTTP客户端并发送请求
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
log.Fatalf("发送请求失败: %v", err)
}
defer resp.Body.Close() // 确保关闭响应体
// 8. 读取并打印响应
fmt.Printf("HTTP 状态码: %d %s\n", resp.StatusCode, resp.Status)
responseBody, err := ioutil.ReadAll(resp.Body)
if err != nil {
log.Fatalf("读取响应体失败: %v", err)
}
fmt.Println("响应体:")
fmt.Println(string(responseBody))
// 9. 检查响应状态码
if resp.StatusCode != http.StatusOK {
log.Printf("请求未成功，状态码: %d", resp.StatusCode)
}
}
4. 代码解析
- bytes.NewBufferString(soapXML): 将SOAP XML字符串转换为io.Reader类型，以便作为请求体传递。
- http.NewRequest("POST", url, requestBody): 这是创建自定义HTTP请求的关键。它接受请求方法（"POST"）、目标URL和请求体。
- req.SetBasicAuth(username, password): 这个方法是解决401错误的核心。它会自动生成并添加一个形如Authorization: Basic base64encoded(username:password)的HTTP头到请求中。
- req.Header.Set("Content-Type", "text/xml"): 明确指定请求体的MIME类型，这对于SOAP服务至关重要。
- client := &http.Client{}: 创建一个http.Client实例。http.Client是发送HTTP请求的入口点，可以配置超时、重定向策略等。
- resp, err := client.Do(req): 使用http.Client发送我们自定义的请求。
- defer resp.Body.Close(): 这是一个重要的最佳实践，确保在函数结束时关闭响应体，以释放网络资源。
- 错误处理: 在整个过程中，我们都加入了错误检查，以提高程序的健壮性。
5. 注意事项与最佳实践
- SOAPAction头部: 对于一些SOAP服务，可能还需要设置SOAPAction HTTP头部。这个头部通常包含操作的URI，具体值取决于SOAP服务的WSDL定义。例如：req.Header.Set("SOAPAction", "http://tempuri.org/ClientGetByGuid")。
- 错误处理: 实际应用中，对网络错误、HTTP状态码（特别是非2xx状态码）和响应体解析的错误处理应该更加完善。
- http.Client复用: http.Client实例是并发安全的，并且内部维护着连接池。在生产环境中，建议复用同一个http.Client实例，而不是为每个请求都创建一个新的。
- 凭据安全: 将用户名和密码硬编码在代码中是不安全的。在实际应用中，应从环境变量、配置文件或密钥管理服务中加载凭据。
- 其他认证方式: 如果服务不使用HTTP Basic Auth，而是其他认证方式（如OAuth2、Bearer Token等），则需要手动设置Authorization头部，例如：req.Header.Set("Authorization", "Bearer your_token_here")。
总结
通过本教程，我们学习了如何在Go语言中解决SOAP XML请求的HTTP 401 Unauthorized问题。核心在于使用http.NewRequest创建请求，并通过SetBasicAuth方法添加HTTP Basic Authentication凭据。掌握这些技术将帮助你更有效地与需要认证的SOAP服务进行交互，构建更加健壮和安全的Go应用程序。
