Làm Chủ Breakpoints và Debug Navigator trong Xcode

Một lỗi UI hiển thị sai không chỉ là chuyện “đặt thêm vài lệnh print”. Với Xcode 27.2 và Swift 6.4.2, bạn có thể dừng đúng thời điểm, đọc call stack, kiểm tra view tree, theo dõi bộ nhớ và đối chiếu crash của bản TestFlight mà không đoán mò. Bài này tập trung vào breakpoints và Debug Navigator trong Xcode, rồi nối chúng với LLDB, logging, Instruments và concurrency debugger để tạo thành một quy trình chẩn đoán hoàn chỉnh.

Cập nhật 2026: bộ công cụ debug đã rộng hơn breakpoint

  • Xcode 27.2 là bản ổn định hiện tại, đi cùng iOS 27.2 và Swift 6.4.2. Các ví dụ dưới đây dùng Swift hiện đại, nhưng nguyên tắc vẫn áp dụng cho UIKit lẫn SwiftUI.
  • Swift 6 language mode bật strict concurrency checking. Compiler có thể chỉ ra dữ liệu không an toàn giữa các isolation domain trước khi lỗi xuất hiện ngẫu nhiên ở runtime.
  • Logger/os.Logger, Instruments, Memory Graph và crash reports bổ sung bằng chứng mà một phiên debug tương tác không thể cung cấp.
  • Debug build và Release/TestFlight build có tối ưu hóa, symbol và timing khác nhau. Một lỗi “biến mất khi đặt breakpoint” vẫn là lỗi cần điều tra.

Breakpoints: dừng chương trình có chủ đích

Source breakpoint là điểm dừng quen thuộc: click vào lề trái của dòng code, chạy app và Xcode tạm dừng trước khi thực thi dòng đó. Click lại để vô hiệu hóa, kéo biểu tượng ra khỏi lề để xóa. Bạn cũng có thể dùng Debug > Deactivate Breakpoints hoặc phím tắt tương ứng khi muốn chạy một lượt mà không bị ngắt.

Hãy đặt breakpoint theo giả thuyết. Với màn hình rỗng, dừng ở nơi nhận dữ liệu, nơi state được cập nhật và ngay trước khi render để biết dữ liệu sai từ API, view model hay UI đọc sai thời điểm.

Các loại breakpoint nên dùng

  • Conditional breakpoint: mở Edit Breakpoint và nhập điều kiện LLDB như items.count == 0 hoặc index == 2. Điều kiện giúp bỏ qua hàng trăm lần chạy trong vòng lặp. Đừng gọi hàm có side effect trong điều kiện.
  • Symbolic breakpoint: dừng khi một symbol được gọi, kể cả khi code nằm trong framework. Nó hữu ích để theo dõi UIViewAlertForUnsatisfiableConstraints, một selector Objective-C hoặc phương thức của module riêng. Nếu symbol Swift bị name mangling, dùng tên đầy đủ hoặc tra cứu bằng LLDB thay vì đoán.
  • Exception breakpoint: bắt Objective-C hoặc C++ exception tại điểm ném ra, trước khi stack bị rút gọn. Bật All khi truy tìm crash do runtime; tắt hoặc giới hạn phạm vi nếu thư viện bên thứ ba cố tình dùng exception cho luồng bình thường.
  • Action breakpoint: thêm Log Message với placeholder @variable@, hoặc thêm Debugger Command như po viewModel. Chọn Automatically continue after evaluating actions để biến breakpoint thành logging tạm thời mà không dừng app.

Debug Navigator và vùng debug

Debug Navigator nằm trong nhóm navigator của Xcode; bài Khám phá giao diện Xcode giúp bạn định vị nó. Khi app đang chạy hoặc dừng tại breakpoint, Debug area hiển thị các thread và call stack. Thread bị dừng thường được đánh dấu; frame trên cùng là vị trí hiện tại, các frame dưới cho biết đường đi đến đó.

Click từng frame để xem source và phạm vi biến tương ứng. Frame hệ thống có thể cho thấy bạn đang ở main thread, callback URLSession hoặc một actor hop. Variables view cho phép mở rộng object và thử giá trị primitive; thay đổi chỉ có tác dụng trong phiên debug, còn LLDB có thể gọi code thật.

Bốn lệnh LLDB đủ dùng mỗi ngày

Lệnh Dùng để làm gì Ví dụ
po In object qua description/debug description; phù hợp với model và view. po self.view
p In giá trị biểu thức đơn giản, thường là Int, Bool, String hoặc Double. p retryCount
bt In backtrace của thread hiện tại để xem chuỗi frame nhanh. bt
expr Đánh giá biểu thức Swift/Objective-C, có thể gọi hàm hoặc thay đổi state. expr self.reload()

po không phải phép đọc vô hại tuyệt đối: description có thể chạy getter hoặc code tùy biến. expr còn nguy hiểm hơn vì có thể thay đổi state và làm mất hiện tượng cần tái hiện. Sau khi thử, hãy restart phiên chạy và kiểm tra lại bằng một reproduction sạch. Khi cần đi từng dòng, dùng n để step over, s để step into, finish để ra khỏi hàm và c để continue.

// File: CartViewModel.swift
func total(for items: [Item]) -> Double {
    var total = 0.0
    for item in items {
        total += item.price * Double(item.quantity)
    }
    return total
}

// Tại breakpoint, thử: p total hoặc po items

Quy trình thực tế: debug một lỗi UI

Giả sử màn hình giỏ hàng đôi khi hiện “Không có sản phẩm” dù API trả về dữ liệu. Bắt đầu bằng reproduction tối thiểu: ghi rõ thao tác, thiết bị, build, tài khoản test và tần suất. Không đặt breakpoint khắp nơi; hãy lập sơ đồ nhỏ: response → mapping → state → render.

  1. Đặt source breakpoint sau khi decoder tạo mảng sản phẩm. Dùng conditional breakpoint chỉ dừng khi items.isEmpty hoặc khi request có một mã test cụ thể.
  2. Ở frame đó, dùng po response, p items.count và bt. Nếu count đã bằng 0, lỗi nằm ở server, decoder hoặc mapping; nếu count đúng, đi tiếp.
  3. Đặt action breakpoint tại setter của state, log @items.count@ và tự continue. So sánh thứ tự callback với lúc view đọc state. Tránh log token, email hoặc payload chứa thông tin cá nhân.
  4. Nếu view có kích thước sai hoặc bị che, chọn Debug View Hierarchy trong debug bar. Công cụ này đóng băng snapshot của view tree để bạn xem containment, frame, constraints, z-order và view nào thực sự đang hiển thị.
  5. Với SwiftUI, kiểm tra identity của ForEach, giá trị @State/@Observable và thread/isolation cập nhật state. Đừng kết luận “SwiftUI render ngẫu nhiên” trước khi xác nhận input và identity ổn định.

Khi tìm ra mapping đã trả mảng đúng nhưng state bị ghi đè bởi một request cũ, sửa ownership và thứ tự dữ liệu, rồi thêm test regression. Debugger dùng để tìm bằng chứng; test và thiết kế state mới là cách giữ lỗi không quay lại.

View hierarchy, memory graph và retain cycle

View hierarchy debugger phù hợp với lỗi layout, constraint, hit-testing và view controller không nằm ở nơi bạn nghĩ. Nó là snapshot nên không thay thế việc đo timing.

Memory Graph Debugger dùng để chụp đồ thị object đang sống. Hãy mở nó sau khi đóng màn hình, tìm instance view controller còn tồn tại và xem đường tham chiếu giữ nó lại. Một retain cycle phổ biến là object giữ closure, closure giữ self, còn task hoặc timer giữ object.

// File: DetailViewController.swift
final class DetailViewController: UIViewController {
    private var onRefresh: (() -> Void)?

    func bind() {
        onRefresh = { [weak self] in
            self?.reloadData()
        }
    }

    deinit {
        Logger.ui.debug("DetailViewController released")
    }
}

Trong ví dụ này, capture yếu phá vòng tham chiếu giữa closure và view controller. Sau khi rời màn hình, đặt breakpoint trong deinit hoặc chụp Memory Graph. Nếu deinit không chạy, đọc retain path thay vì chỉ thêm weak một cách máy móc: delegate thường nên yếu, nhưng ownership của model, task, timer và subscription vẫn phải rõ ràng. Nội dung này nối trực tiếp với bài quản lý bộ nhớ trong Swift và ARC.

Console và logging: bằng chứng có cấu trúc

print hữu ích cho một thử nghiệm ngắn nhưng dễ tạo spam, khó lọc và thường bị bỏ quên. Với code chạy lâu dài, dùng Logger từ os, đặt subsystem theo bundle identifier và category theo feature. Mức debug cho chi tiết phát triển; info, notice, error và fault nên phản ánh mức độ cần xử lý.

// File: AppLogger.swift
import OSLog

let uiLogger = Logger(subsystem: "vn.evotek.SampleApp", category: "cart-ui")

func logSelection(id: String, count: Int) {
    uiLogger.debug("Selected item \(id, privacy: .private(mask: .hash)); count=\(count, privacy: .public)")
}

OSLog privacy là hàng rào quan trọng, không phải thủ tục trang trí. Mặc định hãy coi email, token, nội dung nhập và mã định danh người dùng là private; chỉ đánh dấu public những giá trị vô hại và cần thiết cho chẩn đoán. Kiểm tra lại log ở Console trên máy thật và trong archive; đừng giả định mọi log debug đều xuất hiện giống nhau ở Release.

Instruments, crash log và symbolication

Dùng Xcode debugger để trả lời “đang xảy ra ở dòng nào”; dùng Instruments để trả lời “xảy ra bao nhiêu lần và tốn tài nguyên ra sao”. Leaks tìm nhóm object không giải phóng nhưng không bắt được mọi vấn đề ownership. Allocations giúp xem tăng trưởng heap. Time Profiler cho biết CPU đang tiêu ở stack nào. Chạy workload đại diện, ghi dấu mốc và so sánh trước/sau thay vì chỉ nhìn một con số.

Crash log của thiết bị hoặc TestFlight là bằng chứng từ môi trường người dùng. Nếu log chỉ có địa chỉ hex, hãy kiểm tra archive tương ứng và dSYM: dSYM phải được giữ cùng build number, sau đó symbolicate bằng Xcode hoặc công cụ của pipeline. Không dùng dSYM của build khác; stack có thể trông hợp lệ nhưng dòng nguồn sẽ sai. TestFlight crash reports giúp phát hiện lỗi không tái hiện được trên simulator, còn Organizer hỗ trợ đối chiếu phiên bản và thiết bị.

Đừng nhầm crash với hang. Crash thường có exception type và crashed thread; hang cần xem thread state, main-thread work và watchdog. Thread Sanitizer, Address Sanitizer và Main Thread Checker là các phép kiểm tra có mục tiêu; bật chúng khi tái hiện, vì chúng có thể thay đổi timing.

Concurrency debugger và strict concurrency của Swift 6.4

Concurrency debugger giúp bạn nhìn task, actor, suspension point và quan hệ giữa các async operation khi một tác vụ không tiến triển như mong đợi. Nếu UI không cập nhật, trước hết xác nhận code chạm UI ở MainActor; nếu task chờ vô hạn, kiểm tra cancellation, continuation và task con. Đừng chữa lỗi bằng cách thêm DispatchQueue.main.async ở mọi nơi.

Trong Swift 6 language mode, strict concurrency checking chặn hoặc cảnh báo việc truyền dữ liệu không Sendable, truy cập actor-isolated property từ ngữ cảnh sai và các capture nguy hiểm. Hãy xử lý chẩn đoán theo module: đánh dấu isolation đúng, dùng Sendable cho dữ liệu qua ranh giới, xem xét nonisolated khi thật sự an toàn và chỉ dùng @preconcurrency như cầu nối cho dependency chưa chuyển đổi. “Build được khi tắt cảnh báo” không phải là cách giải quyết race.

Debug và Release không giống nhau

Khía cạnh Debug Release/TestFlight
Tối ưu hóa Dễ step, timing khác, thường chậm hơn. Compiler tối ưu, race và lifetime có thể đổi.
Symbol Thường có source và symbol đầy đủ. Cần archive/dSYM đúng build để đọc crash.
Quan sát Breakpoint, sanitizer, console tương tác. Logger, crash report, metrics và reproduction có kiểm soát.

Vì vậy, sau khi sửa trong Debug, hãy thử một archive gần cấu hình phân phối và kiểm tra trên thiết bị thật. Một breakpoint có thể làm race biến mất; một lệnh po có thể kích hoạt getter; một log quá nặng có thể thay đổi timing. Bằng chứng tốt phải tồn tại cả khi debugger không can thiệp.

Pitfall thường gặp và cách tránh

  • Print spam: thay bằng Logger có category, level và privacy; xóa log thử nghiệm trước khi merge.
  • Breakpoint có side effect: điều kiện, action và po có thể gọi code hoặc làm chậm luồng. Dùng để quan sát, không dùng làm logic sản phẩm.
  • Expr thay đổi state: ghi lại mọi thay đổi, restart rồi tái hiện lại từ đầu trước khi kết luận.
  • Bỏ qua actor isolation: đừng ép mọi thứ về main thread; sửa mô hình ownership và isolation theo dữ liệu thật.
  • Không có symbols: lưu archive và dSYM trong CI, kiểm tra upload symbol trước khi phát hành.
  • Log PII: áp dụng OSLog privacy, scrub payload và xem log như dữ liệu có thể rời khỏi máy phát triển.

Chọn công cụ theo câu hỏi

  • Cần biết giá trị và đường gọi tại một thời điểm: breakpoint, Debug Navigator, p, po, bt.
  • Cần biết view nào đang che hoặc constraint nào sai: View Hierarchy debugger.
  • Cần biết object nào không được giải phóng: Memory Graph, Allocations và Leaks.
  • Cần biết CPU hoặc thời gian nằm ở đâu: Time Profiler.
  • Cần điều tra lỗi chỉ xuất hiện ở người dùng: Logger, crash report, dSYM và TestFlight.
  • Cần tìm race, isolation hoặc task bị treo: strict concurrency diagnostics, Concurrency debugger và sanitizer.

Nhìn tới 2027

Xcode sẽ tiếp tục kéo debug tĩnh, runtime và telemetry lại gần nhau hơn, nhưng nguyên tắc không đổi: tạo reproduction nhỏ, thu thập bằng chứng có thể lặp lại và sửa nguyên nhân sở hữu dữ liệu. Khi iOS 27.x tiếp tục phát triển, hãy kiểm tra lại release notes trước khi dựa vào hành vi mới của SDK hoặc SwiftUI.

Checklist trước khi đóng một bug

  1. Viết reproduction và giả thuyết, rồi đặt breakpoint có điều kiện thay vì dừng mọi lần gọi.
  2. Đọc call stack, thread, biến và state bằng LLDB; tránh thay đổi state trong phiên kiểm chứng cuối.
  3. Chọn đúng công cụ: view hierarchy, Memory Graph, Instruments, sanitizer hoặc concurrency debugger.
  4. Kiểm tra logging không chứa PII và có privacy phù hợp.
  5. Tái hiện trên Release-like build, lưu archive/dSYM và kiểm tra crash report của TestFlight nếu cần.
  6. Thêm test hoặc guard để lỗi đã sửa không quay lại.

Nếu cần ôn lại cách cài và chọn toolchain, xem cài đặt và cấu hình Xcode. Để đặt bài này vào toàn bộ lộ trình, xem iOS Roadmap.