MissingReferenceException trong Unity và cách xử lý

ASCENO / UNITY STUDY NOTES · 61

MissingReferenceException trong Unity và cách xử lý

MissingReferenceException in Unity and How to Handle It

Bài học bắt đầu bằng một ảnh chụp trực tiếp từ Unity để người đọc biết thao tác thực hành. Chín hình sau là minh họa không chữ; phần giải thích song ngữ bên dưới mới là nội dung cần đọc. Chủ đề chính là missing reference unity. Ảnh số 1 là bằng chứng thực hành; ảnh số 2–10 chỉ dùng hình khối, biểu tượng và quan hệ trực quan để có thể giữ nguyên khi chuyển sang ngôn ngữ khác.

Mục tiêu học tập

• Giải thích được khái niệm bằng mô hình hoặc luồng dữ liệu.
• Biết chính xác màn hình Unity nào cần mở.
• Dự đoán kết quả trước khi bấm Play và tìm được bằng chứng.
• Tự dựng lại thí nghiệm nhỏ và xử lý lỗi có phương pháp.

1. Thực hành trực tiếp trong Unity

Mở đúng Scene test, chọn object liên quan và thực hiện thao tác được mô tả trong bài. Hình này là ảnh Unity native để người đọc nhận ra nơi bắt đầu; các bước và ý nghĩa nằm trong phần chữ ngay bên dưới.

2. Minh họa hệ thống

MissingReferenceException thường xuất hiện khi một Unity Object đã bị Destroy nhưng code vẫn giữ và gọi vào reference cũ. Đây là lỗi vòng đời, khác với reference chưa từng được gán. Hình minh họa bên dưới không chứa câu chữ để không bị khóa vào một ngôn ngữ; hãy đọc phần giải thích này cùng các bước cụ thể.

• missing reference unity | khái niệm đang học | đọc phần focus và ví dụ thực hành | không suy luận chỉ từ màu sắc của object
• Input/setting | dữ liệu hoặc cấu hình đầu vào | ghi giá trị trước khi đổi | không đổi nhiều thứ cùng lúc
• Result/evidence | thứ phải quan sát trong Scene, Game, Inspector hoặc Console | chụp đúng panel | không coi ảnh đẹp là bằng chứng

3. Minh họa nguyên nhân → kết quả

Hãy đọc hướng mũi tên, vị trí tương đối và thay đổi của biểu tượng như một quan hệ nhân quả. Không cần dựa vào chữ nằm trong ảnh; phần dưới đây giải thích từng bước bằng văn bản.

1. Reproduce
2. Log
3. Console
4. Stack trace
5. Inspect
6. Fix

4. Minh họa trình tự hoạt động

Mở Unity và xác định đúng cửa sổ tạo ra kết quả của bài; chỉ chụp sau khi tên object, field hoặc output cần học đã nhìn thấy rõ.

5. Minh họa cấu trúc object

Đọc tên object trong Hierarchy trước. Nếu tên không nói lên vai trò, hãy đổi tên trong Scene test; screenshot chỉ có giá trị khi người đọc biết mình đang nhìn object nào.

6. Minh họa cấu hình

Chọn object đại diện cho missing reference unity trong Hierarchy. Đọc Transform trước, sau đó tìm Component/field liên quan. Ghi lại giá trị hiện tại rồi mới thay đổi; Tìm nơi object bị Destroy và nơi callback hoặc manager vẫn giữ reference

7. Minh họa quan sát kết quả

Console không phải ảnh trang trí: dùng nó để xác nhận Xoá object khỏi collection sau khi nó không còn hợp lệ. Nếu bài không sinh log, kiểm tra object active, script compile và Console filter trước khi sửa thêm code.

8. Minh họa code → state

Đừng chép code rời khỏi Scene. Trước mỗi dòng, chỉ ra object/reference đầu vào; sau mỗi dòng, chỉ ra state hoặc output nào phải thay đổi.

using System.Collections.Generic;
using UnityEngine;

public class TargetRegistry : MonoBehaviour
{
    private readonly List<Transform> targets = new();

    public void RemoveTarget(Transform target)
    {
        targets.Remove(target);
    }

    private void LateUpdate()
    {
        targets.RemoveAll(target => target == null);
    }
}

9. Minh họa thí nghiệm

Bài mô phỏng enemy bị xoá trong lúc một manager còn theo dõi, sau đó dùng OnDestroy, event unsubscribe và kiểm tra null đúng ngữ cảnh để xử lý.

1. Tìm nơi object bị Destroy và nơi callback hoặc manager vẫn giữ reference.
2. Huỷ đăng ký event trong OnDisable/OnDestroy khi object subscribe.
3. Xoá object khỏi collection sau khi nó không còn hợp lệ.
4. Chạy lại sau khi hoàn nguyên để kiểm tra kết quả có lặp lại không.
5. Ghi lại giá trị đầu vào, thao tác, kết quả và lý do thay đổi.

10. Minh họa lỗi → cách sửa

• Chọn nhầm object hoặc asset nên sửa đúng chỗ nhưng kết quả không đổi.
• Đổi nhiều field cùng lúc nên không truy được nguyên nhân.
• Chỉ nhìn Scene mà bỏ qua Inspector/Console.
• Không kiểm chứng riêng phần missing reference unity.

Góc nhìn ASCENO: Một hình ảnh tốt phải giúp người đọc trả lời được một câu hỏi cụ thể. Nếu ảnh không cho biết chọn gì, nhìn ở đâu, đổi gì hoặc kết quả nằm ở đâu, ảnh đó chưa đủ điều kiện đưa vào tài liệu.