缺陷标题

深色模式下“账单列表”次级文案对比度不足且顶部筛选标签在小屏设备被裁切（iPhone 13 mini）

基础信息

• 应用名称：微栈理财
• 应用版本：5.0.0
• 缺陷类型：界面显示
• 设备型号：iPhone 13 mini
• 操作系统版本：iOS 16.6
• 主题模式：深色模式
• 影响页面/模块：账单列表
• 复现概率：高（在指定设备与深色模式下多次操作均可复现）

问题描述

• 在暗背景（#121212）下，列表项的次级文案与金额标签颜色偏浅（颜色值疑似为 #444，需确认），导致与背景对比度不足，阅读困难。
• 顶部筛选标签在小屏设备（iPhone 13 mini）出现被裁切或文本溢出现象，布局在筛选切换或滚动时不稳定。
• 用户反馈增多，影响账单浏览与筛选操作的可用性与可读性。

复现步骤

1. 在系统设置中，将外观设置为“深色”（设置 → 显示与亮度 → 外观 → 深色）。
2. 启动“微栈理财”应用（版本 5.0.0）。
3. 进入“账单列表”页面。
4. 观察列表项次级文案与金额标签的文本颜色在暗背景下的视觉对比度。
5. 观察页面顶部筛选标签的显示与布局，尤其在切换筛选条件或滚动时是否出现裁切/挤压。

预期与实际结果

• 预期结果：
  • 主次信息在暗背景下具备足够对比度，满足可读性要求（普通文本对比度符合 WCAG 2.1 AA 标准 ≥ 4.5:1）。
  • 布局在小屏设备上保持稳定，顶部筛选标签完整显示，不裁切。
  • 使用系统动态语义色（如 UIColor.label/secondaryLabel 等）适配深色模式。
• 实际结果：
  • 次级文案与金额标签颜色偏浅，在 #121212 背景上几乎不可读。
  • 顶部筛选标签在小屏设备被裁切或文本挤压，布局不稳定。

严重程度

高（影响主要页面的可读性与可用性，虽不导致崩溃但显著影响核心使用与无障碍合规）

优先级

P1（应优先修复，以减少用户反馈与使用障碍）

附加信息

• 初步原因分析（待验证）：
  • 文本颜色可能使用了固定浅色值（如 #444），未使用适配深色模式的动态语义色（UIColor.label/secondaryLabel/tertiaryLabel 等），导致对比度不足。
  • 未进行暗色模式的对比度合规校验，普通文本对比度可能低于 WCAG 2.1 AA 要求。
  • 顶部筛选标签的 Auto Layout 约束在小屏宽度下未充分适配，可能存在：
    • 固定宽度或过大内边距导致内容溢出；
    • StackView/CollectionView 子视图的 contentCompressionResistancePriority 设置过低，文本易被压缩或裁切；
    • 未针对小屏断点调整字体、间距或布局策略。
• 修复与验证建议：
  • 将相关文本颜色替换为系统动态语义色（UIColor.label/secondaryLabel），背景使用 UIColor.systemBackground/secondarySystemBackground 等语义色，确保在不同模式下自动适配。
  • 使用 Xcode Accessibility Inspector 或对比度校验工具，验证普通文本对比度 ≥ 4.5:1；如需保留品牌色，提供暗色模式专用调色并通过对比度校验。
  • 提高筛选标签文本的 contentCompressionResistancePriority，审查并调整相关约束（最小宽度、边距、断点策略），避免固定宽度导致裁切；在 iPhone 13 mini 及相近宽度设备上验证。
  • 覆盖多语言与动态字体（Content Size Category）场景的 UI 测试，确保深色模式与小屏设备下不裁切、不溢出。
• 证据与材料：
  • 截图：深色模式下账单列表的次级文案与顶部筛选标签显示情况（待附）。
  • 日志：未出现崩溃日志；建议在页面加载与主题切换时记录颜色与布局配置以辅助定位（例如记录当前 traitCollection、所用 UIColor 及约束优先级）。

缺陷标题

冷启动且未授予通知权限时应用在启动阶段崩溃（PushManager 初始化期间 NotificationCenter 注册异常）

基础信息

• 应用名称：晴阅书城
• 应用版本：3.4.2
• 缺陷类型：崩溃/闪退
• 设备型号：iPhone 12
• 操作系统：iOS 17.0
• 安装状态：首次安装，首次冷启动
• 权限状态：通知权限未授予（系统尚未弹出授权或用户未选择）
• 网络环境：未提供
• 构建渠道/类型：未提供
• 复现率：100%

问题描述

在首次安装后直接冷启动应用，应用启动白屏约1秒后闪退。重启应用仍然稳定复现。崩溃发生在 AppDelegate 的 application(_:didFinishLaunchingWithOptions:) 阶段，堆栈指向 PushManager 初始化流程；崩溃日志提示在 NotificationCenter 注册观察者时收到 nil 对象相关异常。

复现步骤

1. 卸载设备上的晴阅书城（如已安装）。
2. 安装晴阅书城 3.4.2 版本。
3. 确认系统设置中“晴阅书城”的通知权限处于未授权初始状态（新安装默认状态，未弹过授权框）。
4. 直接点击图标启动应用（冷启动）。
5. 观察启动过程：出现启动白屏约1秒后应用闪退至桌面。

预期与实际结果

• 预期结果：应用进入首页并弹出系统通知授权提示。
• 实际结果：应用启动白屏约1秒后闪退至桌面；再次启动仍复现，无法进入应用。

严重程度

• 致命（Crash on launch，阻断正常使用）

优先级

• P0（需紧急修复）

初步问题分析

• 崩溃阶段：AppDelegate.didFinishLaunching。
• 关联模块：PushManager 初始化。
• 日志摘要显示在 NotificationCenter 注册观察者时出现 nil 相关异常。
• 可能触发条件：冷启动且通知权限未授予时，PushManager 在权限未就绪或依赖对象未完成初始化的情况下注册通知/观察者。
• 典型风险点（供排查）：
  • 使用 NotificationCenter.addObserver(_:selector:...) 时传入的 observer 为可选对象未解包，导致传入 nil 引发崩溃。
  • 在对象初始化阶段（init/类初始化）即进行通知注册，observer/self 尚未稳定或生命周期不可控。
  • 使用基于闭包的 addObserver(forName:object:queue:using:) 未正确持有返回的 token 或过早释放，导致异常行为（需以具体堆栈确认）。
  • 初始化顺序导致依赖对象（如权限管理器/窗口根视图/会话单例）尚未创建即被访问。

上述分析基于现有日志摘要，具体根因需结合完整符号化堆栈与源码位置确认。

影响评估

• 当前已确认在 iPhone 12 / iOS 17.0，首次安装且未授权通知的场景下复现率 100%，用户无法进入应用。
• 若 PushManager 初始化逻辑在其他机型或 iOS 17.x 版本一致，存在影响更广用户群的风险，建议进行机型与系统版本覆盖验证。

排查与修复建议

• 日志与证据收集

  • 获取并符号化完整 .ips 崩溃报告与主线程堆栈，定位具体崩溃行号与方法签名。
  • 导出 Xcode Devices 控制台日志，过滤 NotificationCenter 与 PushManager 相关输出。
  • 标注 PushManager 初始化路径（调用时机、队列、是否在 didFinishLaunching 的主线程执行）。

• 代码级排查要点

  • 检查所有 NotificationCenter.addObserver 调用：
    • 确保 observer 非空且生命周期受控；可选对象使用 guard let 解包后再传入。
    • 避免在对象构造期间（init）使用 self 作为 observer 进行注册。
    • 使用闭包 API 时，正确持有返回的观察者 token，并在 deinit 移除。
  • 初始化时机优化：
    • 将推送相关初始化从 didFinishLaunching 延后至首个界面展示后（如 applicationDidBecomeActive）或权限状态明确后再执行。
    • 在请求通知授权之前与之后分别处理两条路径，未授权/未决状态下不执行依赖授权结果的逻辑。
  • 依赖保护与容错：
    • 对涉及的单例/弱引用对象做非空校验与防御性编程。
    • 对关键初始化增加失败回退，避免影响主线程启动流程。
  • 观测与埋点：
    • 在 PushManager 初始化各阶段添加结构化日志（权限状态、注册结果、线程、时序标记）以复核启动路径。

• 验证与回归

  • 覆盖 iOS 16.x、iOS 17.0–17.5、不同机型（A14~A17）的首次安装/二次启动/授权变更场景。
  • 验证从未授权→授权、拒绝→设置中开启等状态切换流程的稳定性。
  • 重点回归：首屏渲染时间、是否仍能正常弹出系统通知授权框。

• 临时缓解（如具备开关能力）

  • 通过远程配置/Feature Flag 关闭 PushManager 的启动期初始化，或改为在首屏展示后再初始化，以恢复可用性；修复验证后再开启。

附加信息

• 崩溃日志摘要（来自现场描述）：
  • 发生位置：AppDelegate didFinishLaunching
  • 现象：NotificationCenter addObserver 收到 nil 对象相关异常
  • 调用栈：指向 PushManager 初始化路径
• 建议附件（请补充）：
  • 符号化崩溃报告（.ips 全量）
  • Xcode 设备控制台日志（启动至崩溃全程）
  • 相关源码片段（AppDelegate 启动流程、PushManager 初始化与通知注册代码）
  • 复现视频与截图（含系统通知权限弹框状态）