Xử lý sự cố

Mỗi mục dưới đây gồm triệu chứng (thông báo hiển thị trên giao diện), nguyên nhân và cách khắc phục. Nếu lỗi không có trong danh sách, gửi mã lần chạy trong Lịch sử chạy cho editor hoặc admin của project.

Publish action

Khi publish thất bại, giao diện hiển thị Publish bị từ chối: kèm danh sách lỗi do máy chủ trả về.

Thông báo	Nguyên nhân	Cách sửa
SQL dùng {{x}} nhưng chưa khai báo param này	SQL có {{x}} mà phần Param chưa có param x.	Bấm Thêm N param từ SQL hoặc Thêm param với đúng tên, rồi publish lại.
param "x" không được dùng trong SQL	Param được khai báo nhưng câu SQL không dùng.	Gỡ param đó hoặc dùng param trong SQL.
{{x}} nằm ở vị trí identifier (tên cột/bảng) nên phải khai báo type: enum kèm values	Param nằm ở vị trí tên cột/bảng (ví dụ ORDER BY {{x}}) nhưng không phải enum có danh sách cố định.	Đổi kiểu param thành enum và nhập Giá trị enum. Enum lấy danh sách từ action khác không dùng được ở vị trí này. Xem Tham số.
action kind=read nhưng SQL có UPDATE (hoặc INSERT, DELETE)	Action kiểu Chỉ đọc chứa câu ghi.	Kiểu action không đổi được sau khi publish. Tạo action mới với kiểu Ghi dữ liệu.
SQL có N câu lệnh …	Action có nhiều câu lệnh. Với MySQL, mỗi action chỉ được có đúng một câu lệnh.	Tách thành nhiều action, hoặc dùng JS action để gọi lần lượt.
SQL chứa DDL (…); data source này không bật allowDDL	SQL có DROP, ALTER, TRUNCATE, GRANT…	Bỏ lệnh thay đổi cấu trúc khỏi action.
không parse được SQL, cần review thủ công: …	Máy chủ không phân tích được câu SQL nên không kiểm tra an toàn được.	Viết lại câu lệnh theo cú pháp chuẩn.

Ghi chú

Thông báo lỗi publish do máy chủ tạo ra và hiển thị bằng tiếng Việt ở cả hai ngôn ngữ giao diện.

Chạy action

Triệu chứng	Nguyên nhân	Cách sửa
Không thấy Đưa vào hàng đợi hay Chạy hàng loạt	Hai cách chạy này chỉ có cho action SQL kiểu Ghi dữ liệu.	Action chỉ đọc và JS action chạy trực tiếp bằng Chạy.
Không thấy nút Chạy thử trên trang action	Action chưa được publish lần nào. Bản nháp không chạy được.	Bấm Publish. Nút Chạy thử xuất hiện sau khi publish.
Trang chạy báo Action chưa publish	Như trên.	Publish action ở trang Action trước khi chạy.
Đã sửa action nhưng kết quả chạy vẫn như cũ	Trang Chạy action luôn chạy version đã publish, không chạy bản nháp.	Lưu nháp rồi publish version mới.
Action không có trong danh sách khi chọn prod, hoặc báo “Action chưa áp dụng ở môi trường này.”	Action mới chỉ áp dụng ở các môi trường không phải production.	Editor bật prod ở thẻ Môi trường áp dụng của action (có bước xác nhận).
“Data source của action chưa có kết nối ở môi trường này.”	Chưa lưu kết nối data source cho môi trường đang chọn (hay gặp khi chuyển sang prod).	Admin chuyển sang môi trường đó và lưu kết nối ở thẻ Config theo môi trường.
“Bạn chưa được cấp quyền chạy action này”, hoặc action không có trong danh sách	Action ở chế độ restricted và người dùng chưa được cấp quyền. Quy tắc này áp dụng cả với owner và admin.	Đề nghị admin cấp quyền ở tab Cài đặt & quyền của action. Xem Phân quyền.
“IP của bạn không nằm trong allowlist.”	Môi trường có IP allowlist và IP hiện tại của người dùng không nằm trong danh sách.	Dùng mạng hoặc VPN được phép, hoặc đề nghị admin thêm IP ở trang Môi trường.
“Bạn thao tác quá nhanh. Thử lại sau.”	Vượt giới hạn tần suất chạy.	Chờ một lúc rồi chạy lại. Với action ghi dữ liệu cần chạy nhiều lần, dùng Chạy hàng loạt. Xem Giới hạn.
“Chỉ hiện N dòng đầu — thu hẹp điều kiện để xem hết”	Kết quả vượt Số dòng tối đa của action.	Thêm điều kiện lọc, hoặc đề nghị editor tăng số dòng tối đa.
Lỗi Quá thời gian	Câu lệnh chạy lâu hơn timeout của action, hoặc chờ khoá quá 3 giây.	Thu hẹp truy vấn hoặc thêm chỉ mục. Action ghi dữ liệu có thể chạy nền bằng Đưa vào hàng đợi.
Lỗi Ghi dữ liệu trong action chỉ đọc	Câu lệnh ghi dữ liệu trong transaction chỉ đọc.	Dùng action kiểu Ghi dữ liệu cho thao tác ghi.
Ô chọn báo “Bạn không có quyền xem danh sách này — liên hệ admin của project.”	Param lấy danh sách từ một action nguồn mà người dùng chưa có quyền chạy.	Đề nghị admin cấp quyền chạy action nguồn.
Ô chọn báo “Danh sách này chưa dùng được ở môi trường đang chọn.”	Action nguồn chưa áp dụng ở môi trường này, hoặc data source của nó chưa có kết nối ở đây.	Bật môi trường cho action nguồn và lưu kết nối.

Màn hình (view)

Triệu chứng	Nguyên nhân	Cách sửa
Màn hình hiện nhưng một phần trống, kèm “Một phần màn hình này sẽ không có dữ liệu vì bạn chưa được cấp quyền.”	Màn hình chạy bằng quyền của người xem; publish view không cấp thêm quyền. Action mà màn hình gọi trả lỗi từ chối (403).	Admin cấp quyền cho người dùng trên từng action mà màn hình sử dụng.
View không có trong mục Màn hình	View chưa publish, hoặc chưa được bật cho môi trường đang chọn.	Editor publish view và bật môi trường ở thẻ Môi trường áp dụng của view; hoặc người dùng chuyển sang môi trường đã bật.
“Màn hình này chưa áp dụng ở prod” khi mở từ link	Như trên, với môi trường đang chọn.	Đổi môi trường ở thanh trên cùng, hoặc đề nghị editor bật màn hình cho môi trường này.
“View không phản hồi — có thể đang kẹt trong một vòng lặp.”	Code của view chạy liên tục mà không kết thúc.	Bấm Nạp lại, sau đó báo editor sửa code view.

Kết nối data source

Triệu chứng	Nguyên nhân	Cách sửa
Không kết nối được data source	Máy chủ thực thi không tới được host: sai host/port, hoặc firewall chưa mở cho IP ra ngoài của bản triển khai.	Kiểm tra host và port; mở firewall cho IP ra ngoài. Xem Triển khai.
Data source từ chối đăng nhập	Sai user hoặc mật khẩu.	Nhập lại User và Password, rồi bấm Test config đang nhập.
Lỗi chứng chỉ khi bật Bật, kiểm tra chứng chỉ	Cơ sở dữ liệu dùng CA riêng (RDS, Cloud SQL, CA nội bộ).	Nạp file CA ở ô CA (PEM) bằng Chọn file hoặc Dán PEM.
Lỗi tên trong chứng chỉ không khớp	Host là địa chỉ IP, hoặc tên khác với tên trong chứng chỉ.	Điền Tên server trong chứng chỉ. Với MySQL, host phải là tên có trong chứng chỉ.
Máy chủ đòi client certificate	Cơ sở dữ liệu được cấu hình mTLS.	Nạp Client certificate (PEM) và Private key (PEM) không có passphrase.
Test config đang nhập thất bại dù đã lưu đúng	Nút này không dùng mật khẩu và PEM đã lưu.	Nhập lại mật khẩu và PEM, hoặc lưu rồi bấm Test config đã lưu.
“File quá lớn — tối đa 200 KB.”	File PEM vượt giới hạn.	Chỉ nạp phần chứng chỉ cần thiết.
Editor không thấy kết nối của prod	Ở prod, vai trò của editor đó bị giới hạn ở viewer.	Admin nâng Vai trò tối đa lên editor cho môi trường đó, nếu phù hợp.

Biến và secret

Triệu chứng	Nguyên nhân	Cách sửa
Không xem được giá trị của secret	Secret chỉ ghi, không ai đọc lại được, kể cả admin hay owner. Đây là hành vi theo thiết kế.	Để đổi giá trị, bấm Đổi giá trị và ghi đè. Giá trị gốc lấy từ nơi phát hành (nhà cung cấp API, trình quản lý mật khẩu…).
Lưu biến thì được cảnh báo “trông như một bí mật”	Key hoặc giá trị trông giống token hay mật khẩu. Giá trị biến hiển thị với mọi editor và được ghi trong nhật ký.	Bấm Lưu thành secret.
Action lỗi sau khi xoá biến hoặc secret	Action vẫn dùng key đó.	Khai báo lại key, hoặc sửa action để không dùng key đó nữa.

Tài khoản và quyền truy cập

Triệu chứng	Nguyên nhân	Cách sửa
Đăng nhập được nhưng “Bạn chưa được link vào project nào.”	Tài khoản chưa được thêm vào project.	Đề nghị owner link tài khoản vào project, hoặc admin của project thêm ở Phân quyền.
Quên mật khẩu	Hệ thống không gửi email khôi phục.	Đề nghị owner dùng Đặt lại mật khẩu ở trang chi tiết người dùng.
“Đã nhập sai mật khẩu hiện tại quá nhiều lần. Thử lại sau N phút.”	Nhập sai mật khẩu hiện tại nhiều lần khi đổi mật khẩu.	Chờ hết thời gian khoá, hoặc đề nghị owner đặt lại mật khẩu.
Bị đăng xuất bất ngờ trên một thiết bị	Mật khẩu vừa được đổi hoặc đặt lại ở nơi khác.	Đăng nhập lại bằng mật khẩu mới.
“Bạn chưa được cấp quyền vào môi trường này.”, hoặc không thấy prod trong bộ chọn môi trường	Môi trường ở chế độ restricted và người dùng chưa được cấp quyền vào.	Đề nghị admin cấp quyền vào ở trang Môi trường.
“Ở prod, trang này cần vai trò Editor trở lên”	Vai trò tối đa của người dùng ở môi trường đó thấp hơn mức trang yêu cầu.	Chọn môi trường khác ở thanh trên cùng, hoặc liên hệ admin.
“Trang này cần vai trò Admin trở lên”	Vai trò của người dùng trong project thấp hơn mức trang yêu cầu.	Liên hệ admin của project.

Quản trị

Triệu chứng	Nguyên nhân	Cách sửa
Lưu IP allowlist bị từ chối	IP hiện tại của người thao tác không có trong danh sách mới.	Bấm Thêm IP của tôi rồi lưu lại.
Xoá action, view hay data source bị chặn: “Còn đang được dùng ở những chỗ trên — gỡ khỏi đó trước rồi xoá lại.”	Đối tượng cần xoá vẫn được JS action, view hay param của action khác sử dụng (với data source: vẫn còn action dùng data source đó).	Gỡ khỏi các vị trí được liệt kê, rồi xoá lại.
Lịch tự tắt	Người dùng mà lịch chạy theo quyền của họ đã bị gỡ khỏi project, mất quyền vào môi trường hoặc bị xoá.	Một editor bật lại lịch. Từ đó, lịch chạy bằng quyền của người bật.
“Không kết nối được máy chủ” hoặc Executor không phản hồi	Nền tảng tạm thời không phản hồi.	Thử lại sau vài phút. Nếu lỗi vẫn còn, liên hệ đội hỗ trợ.