Sửa lỗi PostgreSQL 'column reference is ambiguous' Khi JOIN Bảng

Lỗi Gặp Phải

Bạn chạy một câu truy vấn JOIN và PostgreSQL dừng lại ngay lập tức:

ERROR: column reference "id" is ambiguous
LINE 1: SELECT id, name FROM orders JOIN users ON orders.user_id = u...

Cột được đề cập trong thông báo lỗi có thể là created_at, status, hoặc name — không quan trọng. Nguyên nhân gốc rễ luôn giống nhau: hai hoặc nhiều bảng có cùng tên cột, và PostgreSQL sẽ không tự đoán bạn muốn dùng cột nào. Nó từ chối thực thi. Thực ra đây là điều tốt — dữ liệu sai mà không có cảnh báo còn tệ hơn nhiều so với một lỗi rõ ràng.

Nguyên Nhân

PostgreSQL thấy cột id xuất hiện ở cả bảng orders lẫn users. Nó không có cách nào chọn một trong hai, nên nó báo lỗi nhập nhằng thay vì âm thầm trả về dữ liệu cũ hoặc sai.

Có ba tình huống thường xuyên gây ra lỗi này trong thực tế:

• Bạn refactor một câu truy vấn đơn bảng thành JOIN nhưng quên thêm tên bảng trước các cột trong mệnh đề SELECT.
• Ai đó thêm cột created_at vào một bảng thứ hai — câu truy vấn hiện tại của bạn lập tức bị lỗi dù code không thay đổi gì.
• Bạn sao chép một câu truy vấn đang hoạt động, thêm JOIN vào, nhưng không cập nhật danh sách cột trong SELECT.

Cách Sửa 1: Thêm Tên Bảng Trước Mỗi Cột Không Rõ Ràng

Thêm tên bảng làm tiền tố cho mỗi cột. Đơn giản, rõ ràng, không còn nhập nhằng.

-- TRƯỚC (bị lỗi)
SELECT id, name, email
FROM orders
JOIN users ON orders.user_id = users.id;

-- SAU (hoạt động)
SELECT orders.id, users.name, users.email
FROM orders
JOIN users ON orders.user_id = users.id;

Đừng chỉ kiểm tra mệnh đề SELECT. Hãy kiểm tra cả WHERE, ORDER BY, GROUP BY, và HAVING. Bất kỳ cột nào không được chỉ định bảng mà xuất hiện ở nhiều bảng đều sẽ gây ra lỗi tương tự.

Cách Sửa 2: Dùng Alias Cho Bảng Để Câu Truy Vấn Dễ Đọc Hơn

Viết tên_bảng_rất_dài.tên_cột ở khắp nơi trông rất rườm rà. Alias ngắn gọn giải quyết vấn đề đó.

SELECT o.id   AS order_id,
       u.id   AS user_id,
       u.name AS user_name,
       o.created_at
FROM orders o
JOIN users  u ON o.user_id = u.id
WHERE o.status = 'pending'
ORDER BY o.created_at DESC;

Khai báo alias ngay sau tên bảng — orders o — rồi dùng o. và u. ở mọi nơi. Câu truy vấn trở nên dễ đọc và dễ bảo trì hơn khi sau này cần thêm bảng thứ ba.

Cách Sửa 3: Đặt Lại Tên Cột Trong Danh Sách SELECT

Đôi khi bạn cần cả hai cột bị xung đột — chẳng hạn cả orders.id lẫn users.id. Hãy đặt alias riêng cho chúng để tập kết quả có ý nghĩa rõ ràng về sau.

SELECT o.id   AS order_id,
       u.id   AS user_id,
       u.email,
       o.total
FROM orders o
JOIN users u ON o.user_id = u.id;

Nếu không đặt alias, ORM hoặc ứng dụng của bạn sẽ nhận được hai cột đều có tên id. Hầu hết các framework sẽ âm thầm bỏ đi một trong hai. Bỏ cái nào? Tùy driver. Đây là một bug đang chờ ngày bùng phát trên môi trường production.

Cách Sửa 4: Thay SELECT * Bằng Danh Sách Cột Cụ Thể

SELECT * trong một JOIN sẽ lấy toàn bộ cột từ mọi bảng — bao gồm tất cả các cột trùng tên. PostgreSQL cho phép điều này trong một số ngữ cảnh mà không báo lỗi, nhưng tập kết quả sẽ có nhiều cột cùng tên id, created_at, v.v.

-- Tránh dùng cách này với JOIN
SELECT * FROM orders JOIN users ON orders.user_id = users.id;

-- Liệt kê rõ ràng những gì bạn cần
SELECT o.id, o.total, o.status,
       u.name, u.email
FROM orders o
JOIN users u ON o.user_id = u.id;

Danh sách cột rõ ràng cũng bảo vệ bạn khi ai đó thay đổi schema bảng — bạn sẽ không vô tình kéo các cột mới vào response của API.

Cách Sửa 5: Đặt Alias Cột Ngay Trong Subquery hoặc CTE

Không thể sửa câu truy vấn ngoài? Có thể nó nằm trong một view hoặc stored procedure cũ. Hãy bọc một trong các bảng vào subquery và đổi tên các cột xung đột ngay tại đó.

SELECT o.id, o.total, u_info.user_id, u_info.user_name
FROM orders o
JOIN (
    SELECT id AS user_id, name AS user_name, email
    FROM users
) u_info ON o.user_id = u_info.user_id;

Với các câu truy vấn phức tạp hơn, dùng CTE sẽ dễ đọc hơn:

WITH user_info AS (
    SELECT id AS user_id, name AS user_name, email
    FROM users
)
SELECT o.id, o.total, u.user_id, u.user_name
FROM orders o
JOIN user_info u ON o.user_id = u.user_id;

Kiểm Tra Kết Quả

Chạy lại câu truy vấn. Kết quả sạch trông như thế này:

 order_id | user_id | user_name | total
----------+---------+-----------+-------
        1 |      42 | Alice     | 99.00
        2 |      17 | Bob       | 45.50
(2 rows)

Đang debug một câu truy vấn dài trong psql? Hãy chạy \errverbose ngay sau khi gặp lỗi. Lệnh này in ra toàn bộ context lỗi — số dòng chính xác và vị trí ký tự của tham chiếu nhập nhằng — nhanh hơn nhiều so với việc dò từng dòng trong 50 dòng SQL.

\errverbose

Phòng Ngừa

• Chỉ định tên bảng ngay từ JOIN đầu tiên, đừng đợi đến lần lỗi thứ hai. Hãy tạo thói quen từ sớm — không tốn thêm gì và tiết kiệm nhiều thời gian debug.
• Cấm dùng SELECT * trong các câu truy vấn có JOIN. Chỉ liệt kê những cột mà code thực sự cần dùng.
• Đặt alias cho cả hai phía khi chọn cột cùng tên. Hai cột đều tên id trong một tập kết quả sẽ âm thầm làm hỏng hầu hết các ORM.
• Kiểm tra tên cột trước khi chạy ALTER TABLE. Một cột mới có thể làm hỏng các câu truy vấn hiện có khi JOIN với bảng có cùng tên cột — hãy grep qua các câu truy vấn trước khi chạy migration.
• Dùng SQL linter trong CI. Các công cụ như squawk hoặc pgFormatter sẽ đánh dấu các cột chưa được chỉ định bảng trong câu truy vấn đa bảng trước khi chúng đến được môi trường production.