Xcode Preview无法显示：Swift连接Django后端后预览空白求助

你遇到的预览空白问题，大概率是以下几个原因导致的，逐个排查：

1. 预览环境无法访问本地Django服务 #

http://127.0.0.1:8000 是你电脑的本地地址，但SwiftUI预览器/模拟器的网络环境和电脑隔离，模拟器里的127.0.0.1指向的是模拟器自身，而非你的电脑。

解决方法：

• 把URL换成你电脑的局域网IP地址（比如http://192.168.x.x:8000/api/account/），可通过终端ifconfig（Mac/Linux）或ipconfig（Windows）查看。
• 启动Django时用python manage.py runserver 0.0.0.0:8000，允许外部设备访问（默认runserver仅允许本地访问）。

2. JSON日期解码不匹配 #

Swift的JSONDecoder默认使用ISO8601日期格式，但Django REST Framework返回的日期格式通常是yyyy-MM-dd'T'HH:mm:ssZ这类带时区的格式，默认解码策略会失败，导致accounts数组始终为空。

解决方法：
给JSONDecoder设置适配Django的日期解码策略：

// 替换原解码代码
if let data = data {
    do {
        let decoder = JSONDecoder()
        let dateFormatter = DateFormatter()
        dateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZ"
        dateFormatter.locale = Locale(identifier: "en_US_POSIX")
        decoder.dateDecodingStrategy = .formatted(dateFormatter)
        
        let response = try decoder.decode([Account].self, from: data)
        DispatchQueue.main.async {
            self.accounts = response
        }
    } catch {
        print("解码失败：\(error)")
    }
}

不确定Django返回格式的话，先打印String(data: data, encoding: .utf8)查看实际JSON内容。

3. 无错误捕获，无法定位问题 #

当前代码用try?吞掉了解码错误，也没处理请求错误和响应状态码，根本不知道是请求失败还是解码失败。

解决方法：
添加完整的日志排查：

URLSession.shared.dataTask(with: request) { data, response, error in
    // 打印请求错误
    if let error = error {
        print("请求错误：\(error.localizedDescription)")
        return
    }
    
    // 检查响应状态码
    if let httpResp = response as? HTTPURLResponse {
        print("响应状态码：\(httpResp.statusCode)")
        if httpResp.statusCode != 200 {
            print("请求失败，状态码非200")
            return
        }
    }
    
    // 打印返回的JSON内容
    if let data = data, let jsonStr = String(data: data, encoding: .utf8) {
        print("返回JSON：\(jsonStr)")
        // 解码逻辑...
    }
}.resume()

查看Xcode控制台日志，就能明确问题所在。

4. View结构缺少容器 #

直接把ForEach放在body里，SwiftUI需要容器视图（如List、VStack）承载多个子视图，否则无法正确渲染。

解决方法：
用List包裹ForEach：

var body: some View {
    List {
        ForEach(accounts, id: \.self) { item in
            HStack {
                Text(item.first_name)
            }
        }
    }
    .onAppear(perform: loadAccount)
}

5. Django未配置CORS #

如果Django后端没配置跨域，SwiftUI的请求会被同源策略拦截，导致请求失败。

解决方法：
安装并配置django-cors-headers：

1. 安装：pip install django-cors-headers
2. 在settings.py中添加：

INSTALLED_APPS = [
    ...
    'corsheaders',
    ...
]

MIDDLEWARE = [
    ...
    'corsheaders.middleware.CorsMiddleware',
    'django.middleware.common.CommonMiddleware',
    ...
]

# 开发环境允许所有来源，生产环境需指定具体域名
CORS_ALLOW_ALL_ORIGINS = True

6. 预览器未触发onAppear #

部分情况下SwiftUI预览器不会触发onAppear，导致loadAccount未执行，accounts为空。

解决方法：
预览时手动传入测试数据，先验证View渲染逻辑：

// 修改AccountView定义
struct AccountView: View {
    var accounts: [Account]
    // ... 其他代码保留，移除@State变量
    
    func loadAccount() {
        // 原加载逻辑保留
    }
}

// 修改预览代码
struct AccountView_Previews: PreviewProvider {
    static var previews: some View {
        let testData = [Account(
            email: "test@example.com",
            username: "test",
            first_name: "Test",
            last_name: "User",
            is_venue: false,
            date_joined: Date(),
            last_login: Date(),
            is_active: true,
            is_admin: false,
            is_superuser: false
        )]
        AccountView(accounts: testData)
    }
}

确认View渲染正常后，再排查数据加载问题。

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