Khắc phục sự cố

Bắt đầu với code của lỗi. LangDriftError.issues chứa đường dẫn JSON Pointer cho lỗi kiểm tra. SetupError.files và .fields xác định xung đột thiết lập và đầu vào còn thiếu.

Tải dự án

`PROJECT_NOT_FOUND`

Không tìm thấy thư mục gốc .git khi tìm lên các thư mục cha, hoặc thiếu .drifts/project.json. Hãy chỉ rõ thư mục gốc hiện có mong muốn hoặc chạy thiết lập cục bộ tại đó.

`PROJECT_INVALID`

Tệp dự án là JSON sai định dạng hoặc không khớp lược đồ dự án. Hãy kiểm tra thủ công. Thiết lập giữ nguyên nội dung xung đột và không thay thế nó.

`SCHEMA_UNSUPPORTED`

Một sự kiện, hiện vật, dự án hoặc vỏ bọc lập luận khai báo phiên bản lược đồ khác 1. Ứng viên phát hành này không có phương án di chuyển. Đừng đổi số phiên bản mà chưa kiểm tra dữ liệu theo lược đồ phiên bản 1.

Hiện vật và tham chiếu

`ARTIFACT_INVALID`

Các nguyên nhân hiện tại gồm:

JSON sai định dạng hoặc phần đầu langdrift thiếu/không hợp lệ
sử dụng .md / .json không được hỗ trợ hoặc kiểu không khớp thư mục
trường không xác định hoặc sai lệch lược đồ khác
tệp hoặc nội dung vượt 1 MiB
giới hạn phát hiện không hợp lệ hoặc vượt giới hạn tệp/thư mục
định danh cục bộ (type, id) trùng lặp
tác động Drift không nhất quán hoặc thiếu nguồn gốc bằng chứng
dữ liệu mẫu pull request đã hợp nhất trên GitHub không hợp lệ

Đọc đường dẫn trường trong issues. Trình phân tích không suy ra định danh còn thiếu từ tiêu đề hoặc tên tệp.

`PATH_OUTSIDE_ROOT`

Đường dẫn là tuyệt đối, đi lên thư mục cha, chứa đoạn hoặc ký tự cấm, hoặc chạm tới liên kết tượng trưng. Dùng đường dẫn tương đối thông thường bên dưới cây .drifts của dự án. Phát hiện không bao giờ đi theo liên kết tượng trưng.

Vấn đề tham chiếu

REFERENCE_NOT_FOUND và REFERENCE_CYCLE được trả về trong resolveReferences(...).issues; không bị ném thành ngoại lệ. Đăng ký định danh bên ngoài đã biết tường minh, sửa đúng kiểu/ID/đường dẫn hoặc loại bỏ chu trình cục bộ trước khi vận chuyển dữ liệu.

Thông tin xác thực và vận chuyển

`CREDENTIAL_MISSING`

Tham chiếu không có dạng env:NAME, hoặc giá trị môi trường thiếu hay chứa ký tự xuống dòng hoặc byte rỗng. Chỉ truyền tham chiếu và cung cấp giá trị cho môi trường chạy.

`REMOTE_UNAUTHORIZED`

Lớp vận chuyển được truyền vào báo 401 hoặc 403. Các giá trị định tuyến account_id và project_id không cấp quyền; hãy kiểm tra thông tin xác thực lúc chạy và chính sách đích.

`REMOTE_REJECTED`

Lớp vận chuyển được truyền vào báo một trạng thái 4xx khác. Kiểm tra vỏ bọc đã xác thực và hợp đồng đích.

`MCP_UNAVAILABLE`

Vận chuyển thất bại mà không có phản hồi 4xx được phân loại. Không có dữ liệu nào được xếp hàng cục bộ. Chỉ thử lại sau khi kiểm tra bộ điều hợp do bên gọi cung cấp.

Thiết lập

ROOT_INVALID — --root không trỏ đến thư mục hiện có.
SETUP_ARGUMENT_MISSING — cung cấp ID dự án, ID tài khoản và tên trong lần chạy không tương tác.
SETUP_ARGUMENT_INVALID — kiểm tra cờ được hỗ trợ, cờ boolean xung đột và cặp ID cài đặt GitHub dạng số với owner/repository.
SETUP_CONFLICT — kiểm tra trạng thái và lý do của từng tệp. Bước kiểm tra trước chưa ghi gì.
SETUP_PATH_CONFLICT — đường dẫn được quản lý là liên kết tượng trưng hoặc có phần tử cha không phải thư mục.
SETUP_CONCURRENT_CHANGE — một đích thay đổi sau bước kiểm tra trước và đã được giữ nguyên.
SETUP_WRITE_FAILED — lỗi I/O làm gián đoạn việc tạo. Tệp đã tạo trước đó có thể vẫn còn; hãy kiểm tra và chạy lại.

.drifts/execution chủ ý gây xung đột vì phiên bản này dùng Loop và không di chuyển cấu trúc cũ.

Để chẩn đoán ứng dụng an toàn, reportError(error, logger) xuất mã lỗi, thông báo tổng quát và các vấn đề kiểm tra. Nó bỏ qua nội dung và dấu vết ngăn xếp của ngoại lệ không xác định.