TableView多单元格展示异常：近30天生日/纪念日数据加载问题

看起来你在实现“展示未来30天内生日或纪念日”的TableView功能时，遇到了重复单元格的问题。我来帮你梳理下常见的原因和对应的解决办法：

一、先排查数据源是否存在重复或筛选逻辑错误 #

重复单元格最常见的原因之一就是数据源数组customerDetails里有重复数据，或者筛选逻辑没正确过滤出符合条件的记录。

1. 修复日期判断逻辑（关键：处理每年重复的生日/纪念日） #

首先要确保你的isDateInNextThirtyDays方法能正确识别每年重复的日期（比如生日不是只看当年，还要考虑跨年的情况，比如12月底时，1月初的生日也属于未来30天）。这里给你一个更严谨的实现：

func isDateInNextThirtyDays(_ targetDate: Date) -> Bool {
    let calendar = Calendar.current
    let today = calendar.startOfDay(for: Date())
    guard let thirtyDaysLater = calendar.date(byAdding: .day, value: 30, to: today) else {
        return false
    }
    
    // 提取目标日期的月、日，生成今年和明年的对应日期
    let targetComponents = calendar.dateComponents([.month, .day], from: targetDate)
    guard let thisYearDate = calendar.date(from: targetComponents) else { return false }
    let nextYearDate = calendar.date(byAdding: .year, value: 1, to: thisYearDate)!
    
    // 判断今年的日期是否在未来30天内，或者明年的日期是否在范围内（处理跨年场景）
    return (thisYearDate >= today && thisYearDate <= thirtyDaysLater) ||
           (nextYearDate >= today && nextYearDate <= thirtyDaysLater)
}

2. 正确筛选数据源 #

确保你是从原始全量数据中过滤出符合条件的记录，而不是重复添加数据到customerDetails：

// 假设你的全量数据源是allCustomerDetails
func updateUpcomingEventsDataSource() {
    customerDetails = allCustomerDetails.filter { customer in
        // 生日或纪念日符合条件即可
        return isDateInNextThirtyDays(customer.birthday) || isDateInNextThirtyDays(customer.anniversary)
    }
    // 筛选完成后刷新TableView
    tableView.reloadData()
}

记得在合适的时机调用这个方法，比如APP启动时、进入页面时，或者每天首次打开页面时。

二、修复TableView单元格复用的残留问题 #

另一个常见原因是单元格复用时没有重置旧内容，导致滚动时旧数据残留，看起来像是重复单元格。

修改你的cellForRowAt方法，确保复用前先清空所有UI元素：

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "bdayWishesCellIdentifier", for: indexPath) as! BestWishesTableViewCell
    
    // 关键：先重置单元格所有内容，避免复用残留
    cell.nameLabel.text = nil
    cell.birthdayIndicatorLabel.text = nil
    cell.anniversaryIndicatorLabel.text = nil
    // 其他自定义UI元素也要逐一重置
    
    // 再设置当前数据
    let bdayObj = customerDetails[indexPath.row]
    cell.nameLabel.text = bdayObj.name
    
    // 处理生日展示
    if isDateInNextThirtyDays(bdayObj.birthday) {
        let formatter = DateFormatter()
        formatter.dateFormat = "MM月dd日"
        cell.birthdayIndicatorLabel.text = "生日：\(formatter.string(from: bdayObj.birthday))"
    }
    
    // 处理纪念日展示
    if isDateInNextThirtyDays(bdayObj.anniversary) {
        let formatter = DateFormatter()
        formatter.dateFormat = "MM月dd日"
        cell.anniversaryIndicatorLabel.text = "纪念日：\(formatter.string(from: bdayObj.anniversary))"
    }
    
    return cell
}

三、额外检查点 #

• 确认customerDetails数组没有被重复赋值或追加数据，比如多次调用筛选方法却没有清空数组
• 如果是使用Core Data或其他持久化框架，检查查询逻辑是否返回了重复的实体对象

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