Cách gỡ lỗi tự động hóa trình duyệt bằng log Console và Network
TL;DR
Việc gỡ lỗi tự động hóa trình duyệt nên tách biệt kết nối phiên, lựa chọn trang, chuyển giao mạng, kết xuất, và chấp nhận nhiệm vụ.
Thông điệp từ bảng điều khiển mô tả hoạt động của trang; phản hồi lỗi HTTP và các lỗi vận chuyển yêu cầu các trình xử lý sự kiện khác nhau.
Cài đặt các bộ lắng nghe lập trình trước khi điều hướng hoặc hành động mà bạn muốn chẩn đoán.
Việc chọn một trang trong DevTools bảng điều khiển không chọn trang đó trong script tự động hóa của bạn.
Kiểm tra trực tiếp cho thấy một trình duyệt đang hoạt động; phát lại phiên đã lưu tái xây dựng các thay đổi trên trang đã ghi lại và không thể điều khiển trình duyệt.
Ràng buộc và biên soạn chẩn đoán, và dừng phiên sau khi điều tra vì việc gỡ lỗi có thể tiếp tục tiêu tốn thời gian chạy.
Việc gỡ lỗi tự động hóa trình duyệt Nên Nói Gì Với Bạn?
Gỡ lỗi tự động hóa trình duyệt nên cho bạn biết lớp nào đã thất bại và bằng chứng nào hỗ trợ cho kết luận đó. Một khách hàng đã kết nối chỉ thiết lập chuyển giao đến trình duyệt. Nhiệm vụ vẫn có thể thất bại vì trang bị chọn sai, một yêu cầu ứng dụng trả về lỗi, JavaScript bị sập, hoặc một trình chọn sẵn sàng không còn phù hợp với chế độ xem dự kiến.
Nstdata Cloud Browser cung cấp trình duyệt đám mây quản lý cho tự động hóa trình duyệt và các đại lý AI với kiểm tra trình duyệt trực tiếp và chẩn đoán phiên có sẵn. Hướng dẫn này kết hợp cái nhìn bảng điều khiển đó với một bản ghi log Playwright đã ràng buộc. Mục tiêu là xác định bước thất bại mà không cần thu thập toàn bộ phiên lướt web riêng tư vào một vé.
Hướng dẫn Playwright hands-on tutorial giới thiệu các kiểm tra trang mức nhiệm vụ. Ở đây, điều kiện chấp nhận là rõ ràng: tài liệu chính phải thành công và đánh dấu sẵn sàng đã cấu hình phải trở nên hiển thị. Bằng chứng từ bảng điều khiển và mạng giải thích một thất bại nhưng không thay thế điều kiện đó.
Làm Thế Nào Để Bạn Quyết Định Lớp Nào Để Kiểm Tra Trước?
Kiểm tra điều kiện tiên quyết thất bại sớm nhất: trạng thái phiên, kết nối khách hàng, trang dự kiến, yêu cầu quan trọng, sau đó là kết quả đã hiển thị. Thứ tự này tránh việc viết lại các bộ chọn khi trình duyệt đã kết thúc hoặc diễn giải một socket thành công như một hoạt động kinh doanh hoàn thành.
Nstdata Cloud Browser Trình duyệt của bạn trên đám mây
Quan sát
Lớp cần kiểm tra
Bằng chứng hữu ích
Không thể gắn kết với CDP
Tài nguyên hoặc kết nối
Trạng thái phiên gốc, thời gian hết hạn chứng thực, thời gian chờ của khách hàng
Trình duyệt đã kết nối, chế độ xem không mong đợi
Danh tính trang
Nguồn/đường dẫn dự kiến, đánh dấu tài khoản, tài liệu hoạt động
Chế độ xem tải nhưng dữ liệu bị thiếu
Mạng/ứng dụng
Trạng thái HTTP của yêu cầu cần thiết hoặc lỗi vận chuyển
Trang trở nên trống hoặc không hoàn chỉnh
Kết xuất
Ngoại lệ trang, DOM hiện có, script/tài nguyên thất bại
Nhiệm vụ báo cáo thành công không chính xác
Logic chấp nhận
Đánh dấu kết quả cần thiết và đầu ra mong đợi
Một tài liệu chính có thể trả về phản hồi thành công trong khi một yêu cầu API thất bại sau đó. Một tiêu đề nhìn thấy có thể xuất hiện trước các bản ghi mà nhiệm vụ của bạn cần. Thiết kế kết quả mong đợi xung quanh hành vi ứng dụng, sau đó thu thập đủ bằng chứng để phân biệt những trường hợp này. Đừng biến mọi cảnh báo từ bảng điều khiển thành một công việc thất bại.
Bạn Cần Gì Trước Khi Thu Thập Chẩn Đoán?
Bạn cần một mục tiêu đã được cấp phép, một nhiệm vụ có thể tái hiện, một trình chọn sẵn sàng chính xác và sự cho phép để giữ lại dữ liệu chẩn đoán từ trang đó. Sử dụng một ứng dụng staging với nội dung tổng hợp cho lần chạy đầu tiên. Giữ ID phiên Nstdata và ID công việc của bạn sẵn có, nhưng loại trừ các khóa API, token CDP và URL truy cập đã ký toàn bộ ra khỏi các nhật ký.
Đối với phương pháp lập trình, cài đặt Node.js 22.12 hoặc phiên bản muộn hơn và playwright-core. Nhận một khóa API doanh nghiệp qua Settings → Account hoặc một khóa thành viên đã ràng buộc qua Members. Nếu một khóa cá nhân chọn một đội, gửi cùng bối cảnh đội tùy chọn trên tất cả các cuộc gọi vòng đời.
Việc thu thập khách hàng trong bài viết này được thực hiện thông qua một kết nối CDP thực với một trang địa phương bị cô lập mà cố tình phát ra một cảnh báo bảng điều khiển, một ngoại lệ JavaScript, một lỗi HTTP, và một kết nối thất bại. Nhánh chứng thực Nstdata yêu cầu khóa của bạn và đã không chạy trên một tài khoản được quản lý. Các loại sự kiện được trình bày là các quan sát cố định, không phải là các tuyên bố về hiệu suất dịch vụ.
Làm Thế Nào Để Bạn Kiểm Tra Một Trình Duyệt Đang Chạy Trong Bảng Điều Khiển?
Kiểm tra một trình duyệt đang chạy bằng cách mở các công cụ xem trước của nó, kết nối DevTools, và chọn chính xác trang đã thất bại. Hướng dẫn Tự động hóa Trình duyệt hiện tại ghi lại các bảng kiểm tra trực tiếp có sẵn.
Bước 1: Mở phiên đang chạy ban đầu
Mở Cloud Browser → Playground và chọn phiên đã được sử dụng bởi công việc của bạn. Xác nhận Running trước khi khắc phục sự cố trang của nó. Nếu tài nguyên đã kết thúc, kiểm tra trực tiếp không thể kết nối lại; sử dụng lịch sử có sẵn hoặc bắt đầu một bản tái hiện mới cố tình.
Bước 2: Kết nối các công cụ kiểm tra
Click DevTools trong khu vực công cụ xem trước ở góc trên bên phải. Sử dụng Expand Tools nếu khu vực đó bị thu gọn. Chờ cho Connected, sau đó chọn Page mong muốn. Việc chọn trang này sẽ thay đổi mục tiêu kiểm tra, không phải biến trang của kịch bản của bạn.
![Chụp màn hình: DevTools trực tiếp kết nối với trang staging đã chọn, với các tab Console và Network hiển thị và tất cả thông tin xác thực truy cập bị ẩn.]
Bước 3: Kiểm tra bảng điều khiển liên quan
Sử dụng Elements để có ảnh chụp HTML chỉ đọc, Console cho các thông điệp và ngoại lệ mới nhận được, và Network cho phương thức, trạng thái hoặc lý do thất bại, URL, loại MIME và các tiêu đề đã được xử lý. Làm lại hành động thất bại hẹp sau khi gắn các công cụ khi phù hợp; không giả định rằng một trình kiểm tra chứa mọi sự kiện từ trước khi kết nối.
Nếu phần tử chỉ tồn tại trong một khung, hãy kiểm tra tài liệu chính xác và điều chỉnh lựa chọn khung của kịch bản. Nếu ứng dụng đã đăng xuất, hãy khắc phục việc chuyển nhượng phiên thay vì kéo dài thời gian hết hạn của một phần tử. Bảng điều khiển và kịch bản phải đồng ý về danh tính trang trước khi chứng cứ của chúng có thể được so sánh.
Làm Thế Nào Để Bạn Ghi Lại Chứng Cứ Console và Network Trong Playwright?
Ghi lại chứng cứ bằng cách đăng ký các trình lắng nghe có giới hạn trước khi điều hướng và viết một báo cáo có cấu trúc sau nhiệm vụ trang. Hướng dẫn Playwright network đề cập đến việc quan sát yêu cầu và phản hồi. Ví dụ này lưu giữ siêu dữ liệu sự kiện và cố ý bỏ qua các tiêu đề nguyên bản, thân trang, URL đầy đủ và văn bản thông điệp console.
Bước 1: Cài đặt client ghi lại
Tạo một dự án và cài đặt phiên bản chính xác của client Playwright được sử dụng ở đây. Một kết nối từ xa không yêu cầu một nhị phân Chromium trên tác nhân này.
mkdir browser-debug-demo
cd browser-debug-demo
npm init -ynpminstall --save-exact playwright-core@1.65.1
Bước 2: Lưu helper kết nối
Lưu mô-đun này dưới tên cloud-api.mjs. Nó xác thực phiên và phản hồi thông tin xác thực ngắn hạn mà không ghi lại token truy cập nào. Để tùy chọn kiểm tra vòng lặp của nó không được đặt khi sử dụng Nstdata.
Điều kiện tiên quyết về thông tin xác thực: các yêu cầu quản lý yêu cầu NSTDATA_API_KEY, NSTDATA_SESSION_ID, và tùy chọn NSTDATA_TEAM_ID. Logic kết nối và ghi lại đã được kiểm tra cục bộ; xác thực quản lý vẫn cần một tài khoản canary.
const root ='https://api.nstdata.io/api/v1/cloud-browser';exportasyncfunctionapi(method, path, body){const key = process.env.NSTDATA_API_KEY;if(!key)thrownewError('Set NSTDATA_API_KEY');const headers ={'x-api-key': key };if(process.env.NSTDATA_TEAM_ID) headers['x-team-id']= process.env.NSTDATA_TEAM_ID;if(body) headers['content-type']='application/json';let response;try{ response =awaitfetch(root + path,{ method, headers,redirect:'error',body: body ?JSON.stringify(body):undefined,signal:AbortSignal.timeout(20_000),});}catch{throwObject.assign(newError('API transport failed; reconcile the original operation'),{retryable:true});}const retryable = response.status===429|| response.status>=500;let result;try{ result =await response.json();}catch{throwObject.assign(newError('Invalid API JSON'),{ retryable });}if(!response.ok|| result.err===true|| result.success===false){throwObject.assign(newError(`Cloud Browser API HTTP ${response.status}`),{ retryable });}if(!result.data)thrownewError('Missing API data');return result.data;}exportasyncfunctionconnection(id){if(!id)thrownewError('Set NSTDATA_SESSION_ID');const path =`/sessions/${encodeURIComponent(id)}`;const session =awaitapi('GET', path);if(session.state!=='ready')thrownewError(`Session is ${session.state}, not ready`);const c =awaitapi('POST', path +'/automation-credentials');if(c.sessionId!== id ||!c.headerName||!c.accessToken||!(Date.parse(c.expiresAt)>Date.now())||newURL(c.cdpUrl).protocol!=='wss:'){thrownewError('Invalid or expired CDP credentials');}return{endpoint: c.cdpUrl,headers:{[c.headerName]: c.headerName.toLowerCase()==='authorization'?`Bearer ${c.accessToken}`: c.accessToken},};}exportasyncfunctionendpoint(){// An isolated local CDP endpoint can test the client without managed credentials.if(process.env.LOCAL_CDP_URL){const url =newURL(process.env.LOCAL_CDP_URL);if(!['127.0.0.1','localhost','[::1]'].includes(url.hostname)){thrownewError('LOCAL_CDP_URL must use loopback');}return{endpoint: url.href,headers:{}};}returnconnection(process.env.NSTDATA_SESSION_ID);}
Bước 3: Lưu kịch bản ghi lại có giới hạn
Lưu mã này dưới dạng debug.mjs. Nó tạo một trang, gắn các listener trước khi điều hướng, và ghi lại kết quả vào browser-debug.json. Giới hạn sự kiện và thời gian chờ là các biện pháp bảo vệ ví dụ của ứng dụng, không phải giới hạn của Nstdata.
Điều kiện tiên quyết về chứng thực: nhánh được quản lý yêu cầu cài đặt tài khoản của trợ lý. Đặt TARGET_URL và READY_SELECTOR cho một ứng dụng được ủy quyền; không có bộ chọn sẵn sàng toàn cầu cho các trang web tùy ý.
The Playwright request event lifecycle phân biệt một phản hồi lỗi HTTP từ một yêu cầu không thể hoàn thành. Một 404 hoặc 503 vẫn là một phản hồi HTTP, vì vậy hãy kiểm tra trạng thái response. Một sự cố vận chuyển xuất hiện qua requestfailed. Kịch bản giữ các loại này riêng biệt thay vì tính chúng là cùng một lỗi.
Bước 4: Chạy một tác vụ có thể tái sản xuất
Tạo một tệp .env riêng tư với khóa, ID phiên, TARGET_URL được ủy quyền và một bộ chọn chứng minh nội dung yêu cầu đã sẵn sàng. Chỉ thêm ngữ cảnh nhóm nếu cần, sau đó chạy kịch bản từ thư mục dự án.
node --env-file=.env debug.mjs
Đọc taskPassed riêng biệt khỏi danh sách sự kiện. Một trang có thể thỏa mãn dấu hiệu được chọn trong khi một hình ảnh không liên quan trả về một lỗi. Ngược lại, một danh sách sự kiện trống không chứng minh thành công nếu dấu hiệu không bao giờ xuất hiện. Trong ví dụ này, một dấu hiệu bị thiếu hoặc tài liệu chính không thành công sẽ tạo ra mã thoát không bằng 0 và một bản ghi task-failed.
Báo cáo cố ý nhóm các nguồn gốc thay vì lưu trữ các URL đầy đủ. Nếu bạn cần xác định một điểm cuối cụ thể, hãy thêm một danh sách cho phép đã được xem xét và ánh xạ các đường dẫn an toàn đã biết đến các nhãn ổn định. Không chỉ đơn giản bật ghi nhật ký yêu cầu thô: các chuỗi truy vấn và đoạn đường có thể chứa bí mật hoặc định danh cá nhân.
Bước 5: Dừng phiên kiểm tra
Nhấp vào Stop Browser và xác nhận rằng phiên gốc đã kết thúc sau khi thu thập bằng chứng cần thiết. Kịch bản đóng trang của nó và giải phóng Playwright; nó không kết thúc phiên được quản lý bởi bảng điều khiển. Giữ báo cáo chỉ trong thời gian điều tra của bạn yêu cầu.
Nstdata Kết Nối Kiểm Tra Trực Tiếp Với Lịch Sử Phiên Như Thế Nào?
Nstdata Cloud Browser kết nối kiểm tra trực tiếp với lịch sử bằng cách cung cấp các công cụ cho trình duyệt đang chạy và các quan sát đã ghi lại khi việc ghi lại được kích hoạt. Các nhà phát triển có thể quan sát trang từ xa trong khi giữ logic tác vụ Playwright hiện có. Danh tính phiên giúp tương quan một công việc không thành công với trình duyệt mà một nhà điều hành đang kiểm tra. Cấu hình proxy tích hợp vẫn là một phần của phiên đó thay vì một thiết lập khách hàng riêng biệt. Ứng dụng của bạn vẫn sở hữu việc xóa bỏ, chấp nhận tác vụ và chẩn đoán lỗi kinh doanh.
Tính khả thi của trình duyệt trực tiếp: so sánh chế độ xem từ xa thực tế với trang mong đợi của kịch bản trước khi thay đổi bộ chọn.
Kiểm tra Console và Mạng: xác định các lỗi mới nhận được và kết quả yêu cầu cho tài liệu đã chọn.
Ghi lại tùy chọn: giữ lại các quan sát trang có sẵn để điều tra sau này khi việc ghi lại được kích hoạt trước khi khởi động.
Điều khiển phiên được quản lý: dừng tài nguyên của cuộc điều tra một cách rõ ràng thay vì để một trình duyệt không kết nối hoạt động.
Giới thiệu Cloud Browser cung cấp tổng quan về sản phẩm. Tính toán thời gian chạy trình duyệt, lưu lượng proxy và việc sử dụng CAPTCHA tùy chọn thông qua bảng giá Cloud Browser. Một cuộc điều tra bị tạm dừng có thể tiêu tốn thời gian chạy ngay cả khi không có công việc tác vụ hữu ích nào đang diễn ra. Hướng dẫn thử lại sản xuất bổ sung chẩn đoán với các chính sách phục hồi cụ thể theo hoạt động.
Làm Thế Nào Để Bạn Xem Lại Một Lỗi Đã Ghi Lại Sau Khi Trình Duyệt Dừng?
Xem lại một lỗi đã ghi lại thông qua Cloud Browser → Session History → session name, với điều kiện việc ghi lại đã được kích hoạt và dữ liệu liên quan còn có sẵn. Kích hoạt Session Recording trước khi khởi động cho một bản tái tạo cần kiểm tra sau này. Sau khi dừng, hãy chờ quá trình lưu trữ thay vì giả định rằng việc ghi lại có thể đọc ngay lập tức.
Chọn Replay Page cho tài liệu đã ghi lại dự kiến, sau đó sử dụng Play, dòng thời gian, và tốc độ phát lại để xác định bước không thành công. DevTools phát lại hiển thị thông tin đã lưu cho trang đã chọn và vị trí phát lại. Mỗi tài liệu có dòng thời gian riêng; đừng suy ra thứ tự đồng bộ giữa các tab từ các chế độ xem phát lại riêng biệt.
Phát lại tái tạo các thay đổi trang đã ghi lại thay vì phát một MP4 hoặc chạy lại ứng dụng. Các kịch bản và tài nguyên bên ngoài không được tải trong quá trình tái tạo, vì vậy hình ảnh, phông chữ và canvas có thể khác nhau. Trạng thái ready đã lưu trữ có nghĩa là dữ liệu có thể đọc, trong khi partial có nghĩa là dữ liệu đã lưu trữ không đầy đủ; không đảm bảo một ảnh chụp nhanh có thể sử dụng cho mọi trang. Dữ liệu bị thiếu, hết hạn, hoặc không được ghi lại không thể được khôi phục thông qua phát lại.
Cần sửa gì trước khi bổ sung cơ chế thử lại?
Sửa danh tính trang, xử lý yêu cầu quan trọng, và logic chấp nhận trước khi thêm các lần thử nghiệm. Một lần thử nghiệm chống lại tab sai sẽ lặp lại tác vụ sai, và một lần thử nghiệm sau một lần gửi không chắc chắn có thể sao chép một hành động. Tái tạo bước ủy quyền nhỏ nhất, phân loại thất bại của nó, và chọn một phản hồi có giới hạn phù hợp với những gì có thể đã hoàn thành.
Giữ cho chẩn đoán tương xứng với cuộc điều tra. Hướng dẫn ghi nhật ký OWASP rất hữu ích khi quyết định các trường nào nên loại trừ. Việc che thông tin đầu vào một mình không xóa được văn bản hoặc dữ liệu trang riêng tư được in bởi trang web. Khi một sửa chữa đã được xác minh, hãy xác nhận cả kết quả tác vụ dự định và việc tắt phiên trước khi kết thúc sự cố.
Một HTTP 404 là một phản hồi, vì vậy hãy xử lý trạng thái của nó thông qua một trình lắng nghe phản hồi. Sử dụng requestfailed cho các yêu cầu không hoàn thành ở cấp độ vận chuyển.
Q: Tại sao các thông điệp console cũ lại thiếu?
Kiểm tra trực tiếp và các trình lắng nghe mới đính kèm có thể chỉ quan sát các thông điệp nhận được sau khi kết nối. Gắn trước khi tái tạo hành động không thành công hoặc sử dụng các chẩn đoán đã ghi lại có sẵn.
Q: Việc chọn một trang DevTools có thay đổi trang kịch bản của tôi không?
Không. Kịch bản của bạn phải chọn trang mà nó mong muốn. Xác nhận cả hai công cụ đang kiểm tra cùng một tài liệu trước khi so sánh bằng chứng.
Q: Replay phiên có phải là trình duyệt mà tôi có thể kiểm soát không?
Không. Replay tái tạo các thay đổi trang đã lưu. Nó không kết nối lại với một trình duyệt trực tiếp cũng như không chạy lại các kịch bản ứng dụng ban đầu.
Q: Có nên để mỗi cảnh báo trong bảng điều khiển làm thất bại công việc không?
Không. Xem xét các cảnh báo như là bằng chứng chẩn đoán và sử dụng các tiêu chí chấp nhận cụ thể cho nhiệm vụ. Quyết định những ngoại lệ và yêu cầu không thành công nào là quan trọng đối với kết quả mong muốn.
Q: Tôi có thể chia sẻ toàn bộ báo cáo gỡ lỗi với một nhà cung cấp không?
Đầu tiên hãy xem xét và chỉnh sửa báo cáo. Các nhật ký, tiêu đề, nội dung trang và URL đã ký có thể tiết lộ thông tin riêng tư ngay cả khi các đầu vào biểu mẫu đã được che giấu.
Hãy để một người điều hành đăng nhập qua Live View trước khi một kịch bản xác minh cùng một tab ứng dụng. Định nghĩa quyền sở hữu, xác nhận tài khoản, ranh giới phê duyệt và dọn dẹp mà không nhúng mật khẩu vào quá trình tự động hóa.
Ivy Lin
Nov. 17th 2026
Khởi chạy trình duyệt đám mây theo nhu cầu
Xử lý dấu vân tay trình duyệt và CAPTCHA
Tự động hóa quy trình và hỗ trợ tác nhân AI
Từ thu thập dữ liệu web và kiểm thử đến tự động hóa bằng AI, vận hành tất cả trên đám mây.