Xử lý lỗi thường gặp

Hướng dẫn xử lý các lỗi thường gặp khi sử dụng GeoCloud

T
Tác giả TLGeo
Thời gian đọc 6 min read

Xử lý lỗi thường gặp

Hướng dẫn này tổng hợp các lỗi thường gặp khi sử dụng GeoCloud và cách khắc phục chi tiết, được tổ chức theo từng chức năng chính của hệ thống.

Danh mục lỗi nhanh

Loại lỗiPhổ biếnThời gian fix
Doanh nghiệp⭐⭐⭐⭐5-15 phút
Dự án⭐⭐⭐⭐⭐10-30 phút
Bản đồ⭐⭐⭐5-20 phút
Phân quyền⭐⭐2-10 phút
Bảo mật⭐⭐⭐5-60 phút
Thanh toán⭐⭐10-24h

Lỗi liên quan đến doanh nghiệp

Không thể tạo doanh nghiệp

Triệu chứng:

  • Nút “Tạo mới” không hoạt động
  • Thông báo lỗi “Tạo doanh nghiệp thất bại”
  • Form không submit được

Nguyên nhân thường gặp:

1. Tài khoản chưa xác thực email

Cách khắc phục:

  1. Kiểm tra email (kể cả thư mục spam)
  2. Click link xác thực trong email
  3. Nếu không nhận được email, click “Gửi lại email xác thực”
  4. Đợi 5-10 phút và thử lại

2. Mã doanh nghiệp đã tồn tại

Cách khắc phục:

  • Thử mã khác: abc_company_2, abc_corp, abc_2024
  • Sử dụng tên viết tắt hoặc thêm năm/khu vực
  • Kiểm tra mã có quá ngắn (tối thiểu 3 ký tự)

3. Thiếu thông tin bắt buộc

Cách khắc phục:

  • Kiểm tra tất cả trường có dấu sao đỏ (*)
  • Đảm bảo tên doanh nghiệp không chứa ký tự đặc biệt
  • Mã doanh nghiệp chỉ chứa chữ cái, số và gạch dưới

Doanh nghiệp không xuất hiện sau khi tạo

Triệu chứng:

  • Tạo doanh nghiệp thành công nhưng không thấy trong danh sách
  • Dashboard không hiển thị doanh nghiệp mới

Cách khắc phục:

Bước 1: Làm mới trang

  1. Nhấn F5 hoặc Ctrl+R (Cmd+R trên Mac)
  2. Hoặc click vào logo GeoCloud để về trang chủ
  3. Vào lại trang “Doanh nghiệp”

Bước 2: Clear cache

  1. Nhấn Ctrl+Shift+R (Cmd+Shift+R trên Mac)
  2. Hoặc mở Developer Tools (F12) > Application > Storage > Clear storage

Bước 3: Đăng xuất và đăng nhập lại

  1. Click avatar > “Đăng xuất”
  2. Đăng nhập lại với tài khoản
  3. Kiểm tra danh sách doanh nghiệp

Lỗi liên quan đến dự án

Không thể tạo dự án COLLECT

Triệu chứng:

  • Button tạo dự án bị disabled
  • Thông báo giới hạn số lượng dự án

Cách khắc phục:

Kiểm tra gói dịch vụ

  • Free Plan: Tối đa 3 dự án
  • Basic Plan: Tối đa 10 dự án
  • Professional Plan: Không giới hạn

Xóa dự án cũ không cần thiết

  1. Vào danh sách dự án
  2. Click ”…” > “Delete” trên dự án không dùng
  3. Xác nhận xóa (không thể hoàn tác)

Upload dữ liệu thất bại

Triệu chứng:

  • File upload bị dừng ở giữa chừng
  • Thông báo “Upload failed” hoặc “Định dạng không hỗ trợ”

Cách khắc phục:

Kiểm tra định dạng file

Hỗ trợ: ✅ Shapefile (.shp + .shx + .dbf + .prj) ✅ GeoJSON (.geojson, .json) ✅ KML/KMZ (.kml, .kmz) ✅ GPX (.gpx) ✅ CSV với cột lat/lon ✅ GeoTIFF (.tif, .tiff)

Không hỗ trợ: ❌ AutoCAD (.dwg, .dxf) ❌ MicroStation (.dgn) ❌ MapInfo (.tab)

Kiểm tra dung lượng file

  • Single file: Tối đa 100MB
  • Total project: Theo gói dịch vụ

Xử lý lỗi Shapefile

  • “Missing required files” → Đảm bảo có đầy đủ: .shp, .shx, .dbf
  • “Invalid geometry” → Kiểm tra trong QGIS: Vector > Geometry Tools > Check Validity

Lỗi hiển thị bản đồ

Bản đồ không load

Triệu chứng:

  • Màn hình trắng thay vì bản đồ
  • Vòng xoay loading mãi không dừng

Cách khắc phục:

Kiểm tra kết nối internet

  1. Thử truy cập website khác
  2. Kiểm tra tốc độ mạng
  3. Thử đổi DNS

Clear map cache

  1. F12 > Application > Storage
  2. Clear “Map tiles cache”
  3. Reload trang

Dữ liệu không hiển thị trên bản đồ

Triệu chứng:

  • Upload thành công nhưng không thấy trên map
  • Layer list có dữ liệu nhưng map trống

Cách khắc phục:

Kiểm tra tọa độ

  • Dữ liệu ở tọa độ sai (VD: 0,0 ở Châu Phi)
  • Zoom to layer extent trong layer panel
  • Kiểm tra coordinate system

Kiểm tra styling

  • Màu fill/stroke giống màu background
  • Thử đổi màu khác trong Style panel
  • Tăng opacity lên 100%

Lỗi phân quyền thành viên

Không thể mời thành viên

Cách khắc phục:

Kiểm tra vai trò

Có thể mời thành viên: ✅ Owner (không giới hạn) ✅ Admin (theo policy doanh nghiệp)

Không thể mời: ❌ Editor, Viewer

Kiểm tra quota

  • Free Plan: Tối đa 5 thành viên
  • Basic Plan: Tối đa 25 thành viên
  • Professional Plan: Không giới hạn

Thành viên không nhận được email mời

Cách khắc phục:

  1. Xác nhận email đúng chính tả
  2. Kiểm tra thư mục Spam/Junk
  3. Thêm noreply@tlgeo.net vào safe senders
  4. Gửi lại lời mời

Lỗi đăng nhập và bảo mật

Quên mật khẩu

Cách khắc phục:

  1. Trang login > “Quên mật khẩu?”
  2. Nhập email đã đăng ký
  3. Kiểm tra email (kể cả spam)
  4. Click link trong email
  5. Đặt mật khẩu mới (tối thiểu 8 ký tự)

Tài khoản bị khóa

Triệu chứng:

  • “Account suspended” hoặc “Tài khoản bị tạm khóa”
  • Không thể login

Nguyên nhân thường gặp:

  • Đăng nhập sai quá nhiều lần
  • Vi phạm chính sách sử dụng
  • Thanh toán bị từ chối

Liên hệ support:

  • Email: support@tlgeo.net
  • Cung cấp: Username/Email, Thời gian bị khóa, Ảnh chụp màn hình lỗi

Lỗi thanh toán và billing

Thanh toán bị từ chối

Cách khắc phục:

Kiểm tra thông tin thẻ

✅ Số thẻ chính xác (16 số) ✅ Ngày hết hạn chưa quá ✅ CVV đúng (3-4 số sau thẻ) ✅ Tên chủ thẻ khớp với hóa đơn

Liên hệ ngân hàng

  1. Xác nhận thẻ có hoạt động international payment
  2. Kiểm tra hạn mức giao dịch online
  3. Xác nhận không bị block merchant

Khi nào cần liên hệ Support?

Trường hợp cần hỗ trợ ngay

  • 🚨 Mất dữ liệu quan trọng
  • 🚨 Không thể truy cập tài khoản > 24h
  • 🚨 Lỗi thanh toán khi deadline gần
  • 🚨 Data corruption hoặc sync issues

Thông tin cần cung cấp

Cung cấp: ✅ Username/Email tài khoản ✅ Tên doanh nghiệp/dự án bị lỗi ✅ Thời gian xảy ra lỗi ✅ Screenshots lỗi ✅ Browser và OS đang dùng ✅ Các bước đã thử để fix

Thời gian phản hồi

  • 🟢 Critical issues: 2-4 tiếng
  • 🟡 Standard support: 24-48 tiếng
  • 🔵 Feature requests: 3-5 ngày làm việc