Swift旅行日记App：AppStorage/UserDefaults数据不持久化问题排查

以下是针对你用AppStorage/UserDefaults存储数据重启丢失问题的常见排查点和修复方案：

核心问题分析 #

AppStorage本质是对UserDefaults的封装，数据丢失大多是因为存储类型不兼容、键名错误或使用场景不当，下面分点说明：

1. 自定义类型未遵循Codable协议 #

UserDefaults仅支持基础类型（String、Int、Double、Bool、Data、URL）及这些类型的数组/字典。如果你的旅行数据是自定义结构体（比如包含地点、图片、日记内容的Trip），直接用AppStorage存储会失败，重启后自然没有数据。

错误示例：

struct Trip: Identifiable {
    let id = UUID()
    var location: String
    var notes: String
    var imageData: Data?
}

struct LandingView: View {
    @AppStorage("trips") var trips: [Trip] = [] // 存储失败，因为Trip未实现Codable
}

修复方法：让自定义类型遵循Codable，通过Data转码存储：

struct Trip: Identifiable, Codable {
    let id = UUID()
    var location: String
    var notes: String
    var imageData: Data?
}

struct LandingView: View {
    // 用Data类型存储转码后的数组
    @AppStorage("trips_data") private var tripsData: Data?
    
    // 计算属性封装读写逻辑
    var trips: [Trip] {
        get {
            guard let data = tripsData else { return [] }
            return try? JSONDecoder().decode([Trip].self, from: data) ?? []
        }
        set {
            tripsData = try? JSONEncoder().encode(newValue)
        }
    }
    
    // 添加旅行时直接操作trips数组，自动触发存储
    func addNewTrip(location: String, notes: String, imageData: Data?) {
        let newTrip = Trip(location: location, notes: notes, imageData: imageData)
        var updatedTrips = trips
        updatedTrips.append(newTrip)
        trips = updatedTrips
    }
}

2. AppStorage键名不统一 #

确保所有读写该数据的视图/逻辑使用完全一致的键名，拼写错误会导致读写不同的UserDefaults条目，表现为数据“丢失”。比如一处用"travel_trips"，另一处用"trips"，就会出现问题。

3. 在ObservableObject中误用AppStorage #

@AppStorage是为View层级设计的属性包装器，如果你的数据逻辑放在ObservableObject视图模型里，应该用@Published配合UserDefaults手动读写，避免存储失效：

class TripViewModel: ObservableObject {
    @Published var trips: [Trip] = []
    private let defaults = UserDefaults.standard
    private let storageKey = "saved_trips"
    
    init() {
        // 初始化时加载数据
        loadSavedTrips()
    }
    
    func loadSavedTrips() {
        guard let data = defaults.data(forKey: storageKey) else { return }
        trips = try? JSONDecoder().decode([Trip].self, from: data) ?? []
    }
    
    func saveTrips() {
        guard let data = try? JSONEncoder().encode(trips) else { return }
        defaults.set(data, forKey: storageKey)
    }
}

在LandingView中使用：

struct LandingView: View {
    @StateObject private var viewModel = TripViewModel()
    
    var body: some View {
        // 界面代码...
        Button("保存旅行") {
            // 修改viewModel.trips后调用保存
            viewModel.saveTrips()
        }
    }
}

4. 验证数据写入时机 #

修改数据后，确保你将更新后的值赋值给了绑定的AppStorage变量或视图模型的Published属性，不要只修改临时数组而不同步到存储源。

5. 排除测试环境干扰 #

如果是在模拟器测试，注意不要误操作“重置内容和设置”，也不要频繁删除重装App，这些操作会清空UserDefaults数据。测试时可以先在修改数据后立即读取，确认数据已存入，再重启App验证。

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