🧰 Hướng dẫn xử lý sự cố khi Build & Khởi chạy iBrowe

Tài liệu này liệt kê các sự cố phổ biến mà lập trình viên có thể gặp phải trong quá trình phát triển iBrowe và cách khắc phục hiệu quả. Nội dung được điều chỉnh từ tài liệu kỹ thuật nội bộ của Brave.

❌ Lỗi khi khởi động hoặc build

1. Lỗi khóa cơ sở dữ liệu (Database Lock Errors)

Ví dụ log lỗi:

[48058:82435:0827/195241.326071:ERROR:database.cc(1821)] Web sqlite error 5, errno 0: database is locked, sql: SELECT COUNT(*) FROM sqlite_master
[48058:82435:0827/195241.326160:FATAL:statement.cc(50)] Cannot call mutating statements on an invalid statement.

🛠️ Cách khắc phục:

Kiểm tra xem có phiên bản trình duyệt nào khác đang sử dụng cùng profile không:

ps aux | grep iBrowe-Browser-Development

Dừng các tiến trình đang chạy:

pkill -f iBrowe-Browser-Development

Hoặc khởi động lại máy và thử lại.

2. Lỗi khởi tạo Git: badTimezone

Thông báo lỗi:

error: object ...: badTimezone: invalid author/committer line - bad time zone

🛠️ Cách khắc phục: Đảm bảo rằng file ~/.gitconfig không chứa các dòng sau:

[transfer]
    fsckobjects = true
[fetch]
    fsckobjects = true
[receive]
    fsckobjects = true

3. Cảnh báo Proxy từ depot\_tools

Thông báo:

NOTICE: You have PROXY values set in your environment...

🛠️ Cách khắc phục: Thêm dòng sau vào file ~/.bashrc:

export NO_AUTH_BOTO_CONFIG="${HOME}/.boto"

Sau đó tạo file ~/.boto với nội dung:

[Boto]

4. Lỗi khi chạy npm run sync -- --all

🧩 Bạn đã quên pull code mới nhất?

Thực hiện:

git pull origin main

Nếu vẫn lỗi, thử xóa thư mục build:

rm -rf src/out

5. Lỗi build liên quan đến Rustup

Thông báo lỗi:

FAILED: gen/challenge_bypass_ristretto/.../libchallenge_bypass_ristretto.a
python ../../ibrowe/script/cargo.py ...
Traceback ...

🛠️ Cách khắc phục:

Dọn sạch và khởi tạo lại:

rm -rf src/out src/ibrowe/vendor src/ibrowe/build
npm run init
npm run build

6. Không tương thích phiên bản Rust Toolchain

Nếu thay đổi phiên bản Rust khiến quá trình build bị lỗi:

🛠️ Cách xử lý:

rm -rf src/ibrowe/build/rustup
npm run sync

7. Mất kết nối với GitHub

Lỗi:

Connection to github.com closed by remote host

🛠️ Cách khắc phục: Cập nhật file cấu hình SSH (~/.ssh/config):

Host github.com
    ServerAliveInterval 60
    ServerAliveCountMax 100

📎 Nguồn: Tài liệu được biên tập lại từ hướng dẫn xử lý sự cố nội bộ của Brave, điều chỉnh cho phù hợp với quy trình phát triển iBrowe.