【Unity】搭建HTTP服务器并解决IP无法访问问题解决

一、核心目标与背景

在Unity中搭建本地HTTP服务器，可以用于实现Web与游戏交互、本地数据接口测试、跨设备通信等场景。但在实际部署中，开发者常遇到以下问题：

​本机IP无法访问：服务绑定localhost时，局域网设备无法连接。
​HTTP 400 Bad Request：因Host校验、路径映射或协议问题导致请求失败。
​跨平台兼容性差：Android/iOS因权限或安全策略无法访问服务。
本文将基于Unity的HttpListener，从服务器搭建到问题解决，提供完整方案。

二、HTTP服务器搭建步骤

1. 创建HTTP服务器脚本

using System.Net;
using System.Threading;
using UnityEngine;

public class HttpServer : MonoBehaviour {
    private HttpListener listener;
    private Thread serverThread;
    private string serverUrl = "http://0.0.0.0:8080/"; // 允许所有IP访问

    void Start() {
        try {
            listener = new HttpListener();
            listener.Prefixes.Add(serverUrl);
            listener.Start();
            serverThread = new Thread(HandleRequests);
            serverThread.Start();
            Debug.Log($"服务器已启动：{serverUrl}");
        } catch (HttpListenerException ex) {
            Debug.LogError($"启动失败：{ex.Message}");
        }
    }

    private void HandleRequests() {
        while (listener.IsListening) {
            try {
                var context = listener.GetContext();
                ThreadPool.QueueUserWorkItem(ProcessRequest, context);
            } catch { /* 正常关闭处理 */ }
        }
    }

    private void ProcessRequest(object state) {
        var context = (HttpListenerContext)state;
        var response = context.Response;
        
        // 处理跨域和Host校验
        response.AppendHeader("Access-Control-Allow-Origin", "*");
        response.AppendHeader("Access-Control-Allow-Methods", "GET, POST");

        try {
            // 示例：返回静态文件
            string filePath = Path.Combine(Application.streamingAssetsPath, context.Request.Url.LocalPath.TrimStart('/'));
            if (File.Exists(filePath)) {
                byte[] data = File.ReadAllBytes(filePath);
                response.OutputStream.Write(data, 0, data.Length);
            } else {
                response.StatusCode = 404;
            }
        } finally {
            response.Close();
        }
    }

    void OnDestroy() {
        listener?.Stop();
        serverThread?.Abort();
    }
}

三、常见问题与解决方案

1. ​IP无法访问

原因：
服务器绑定地址为localhost（仅限本机）。

防火墙或系统安全策略拦截。

未配置跨平台网络权限。

解决步骤：
​修改绑定地址：
a.将serverUrl设置为http://0.0.0.0:8080/。
b.*:8080
c.127.0.0.1:8080

​开放防火墙端口：

​Windows：控制面板 → 防火墙 → 高级设置 → 添加入站规则（TCP）。
​macOS：终端执行sudo pfctl -e。
​配置平台权限：
​Android：在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.INTERNET" />
<application android:usesCleartextTraffic="true" />

​iOS：在Info.plist中添加：

xml
<key>NSAppTransportSecurity</key>
<dict><key>NSAllowsArbitraryLoads</key><true/></dict>

2. ​HTTP 400 Bad Request

原因：
Host头校验失败。
URL路径或参数格式错误。
未正确处理跨域请求。
解决步骤：
​禁用Host校验：

// 在ProcessRequest中移除Host校验逻辑
// 或动态允许所有Host：
context.Request.Headers.Remove("Host");
​统一路径格式：
csharp
string requestPath = context.Request.Url.LocalPath.TrimStart('/').Replace("\\", "/");
​强制跨域支持：
csharp
response.AppendHeader("Access-Control-Allow-Origin", "*");

3. ​Android/iOS无法连接

原因：
未声明网络权限。
Android 9+默认禁止明文HTTP。
解决步骤：
​Android：确保AndroidManifest.xml包含：

<uses-permission android:name="android.permission.INTERNET" />
<application android:usesCleartextTraffic="true" />

​iOS：使用HTTPS或配置ATS例外。

四、最佳实践与优化

1. ​异步处理提升性能

private async void HandleRequestsAsync() {
    while (listener.IsListening) {
        var context = await listener.GetContextAsync();
        ProcessRequest(context);
    }
}

2. ​增强日志输出

Debug.Log($"请求路径：{context.Request.Url.LocalPath}");
Debug.Log($"客户端IP：{context.Request.RemoteEndPoint}");

3. ​动态路径映射

string filePath = Path.Combine(Application.streamingAssetsPath, "web", requestPath);

4. ​安全加固

限制IP访问范围：

if (!context.Request.RemoteEndPoint.Address.ToString().StartsWith("192.168.")) {
    response.StatusCode = 403;
    return;
}

使用HTTPS（需配置SSL证书）。

五、总结

核心配置项 关键值/操作 适用场景

服务器绑定地址 http://0.0.0.0:端口/ 允许所有IP访问

跨域响应头 Access-Control-Allow-Origin: * 解决CORS拦截

Android权限配置 INTERNET + 明文传输许可 Android 9+兼容

通过上述方案，可快速在Unity中搭建稳定的HTTP服务器，并解决IP访问、跨域和平台兼容性问题。建议结合实际场景选择安全策略，并通过日志和抓包工具（如Wireshark）进一步优化调试。