如何在SQL Server中求解錯誤代碼1060？ （逐步）

已發表: 2025-08-07

如果您在SQL Server中工作，並且會看到一個錯誤的錯誤：
“錯誤1060：重複的列名”不要驚慌。看起來很嚴重，但這是一個普遍的錯誤。

當您嘗試通過添加新列更改表格時，通常會顯示這一點，但是列名已經存在。也許您沒有註意到它在那裡。也許腳本運行了兩次。無論哪種方式，SQL Server只是讓您知道：“嘿，這一列已經存在，我無法再添加。”

讓我們以簡單的方式將其分解，以便您可以快速修復它並以後避免使用。

SQL Server錯誤代碼1060是什麼意思？

SQL Server錯誤代碼1060是什麼意思

錯誤1060意味著SQL Server阻止您添加帶有表格中的名稱的列。

它稱為“重複列名稱”錯誤。假設您的表已經有一個名為user_email的列。如果您嘗試使用ALTER TABLE添加帶有同名的另一列，則SQL Server會拋出錯誤1060以停止重複。

這不是一個錯誤。這只是SQL保護數據庫結構的方式。

SQL Server顯示錯誤代碼1060的常見原因

當您在表的設計或運行腳本上工作時，通常會出現此錯誤。無論您是在SQL Server Management Studio（SSM）還是腳本文件中進行操作都沒關係 - 這是關於命令的編寫方式。

以下是出現錯誤1060的日常情況：

  • 您嘗試添加已經存在的列
  • 您兩次運行相同的腳本，而無需檢查列
  • 您從另一個添加重複字段的另一個開發人員中復制腳本
  • 您正在還原數據庫並運行沖突的更新
  • 您使用的自動化工具將應用相同的模式更改不止一次
  • 您正在編輯大桌子，然後丟失列名稱
  • 您正在遷移一個舊的應用程序，並試圖同步新列

這很容易遇到，尤其是在共享項目或重大模式更改上。

如何修復SQL Server錯誤代碼1060？

最初，此錯誤看起來很可怕，但通常很容易修復。您只是想添加表中已經存在的列。因此，關鍵是避免重複或安全處理。

嘗試這些修復。大多數情況下，修復＃1或Fix＃2將立即解決。

修復＃1：檢查列是否已經存在

在嘗試添加新列之前，請先檢查表以查看該列是否已經存在。

您可以使用此SQL查詢：

SELECT COLUMN_NAME
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_NAME = 'your_table_name'

這將顯示表中的所有列。如果您要添加的列已經列出，那就是您的問題。您無需再次添加它 - 從腳本中刪除該部分。這是最安全的第一步。

修復＃2： IF NOT EXISTS您的Alter語句中的使用（如果不存在）

SQL Server不允許確切的邏輯直接在ALTER TABLE中直接IF NOT EXISTS ，但是您可以將Alter命令包裝在此類IF中：

IF NOT EXISTS (
SELECT * FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_NAME = 'your_table_name'
AND COLUMN_NAME = 'your_column_name'
)
BEGIN
ALTER TABLE your_table_name
ADD your_column_name VARCHAR(255)
END

這首先檢查。如果不存在該列，則將其添加。如果已經存在，它會跳過命令，沒有錯誤。對於大多數可能運行多次運行的腳本的最佳修復程序。

修復＃3：查看並清理您的SQL腳本

有時，問題不在您的代碼中 - 這是代碼運行多少次。如果您使用長SQL腳本或遷移文件，請檢查重複的ALTER TABLE命令。也許同一列是偶然添加的。

另外，如果您從另一個來源複製腳本的一部分，請仔細檢查它不包含同一表的重複命令。在管理多個更改時，此清理步驟特別有用。

修復＃4：重命名或刪除重複列（如果需要）

如果該列已經存在但不再需要或沒有錯誤的名稱，則可能需要將其刪除或重命名，然後再添加新的名稱。

放下列：

ALTER TABLE your_table_name
DROP COLUMN your_column_name

重命名列（SQL Server 2016+）：

EXEC sp_rename 'your_table_name.old_column_name', 'new_column_name', 'COLUMN'

警告：如果列在其他地方使用，則丟棄或重命名列可能會破壞您的應用程序。僅當您確定列安全刪除或更改時才使用此此操作。

修復＃5：使用SQL Server Management Studio（SSM）檢查模式

有時，這有助於視覺上看到事物。打開SSM，連接到您的數據庫，然後展開表。您將看到列出的所有列名。如果列已經存在或添加了不同的拼寫，則可以更輕鬆地發現。

確認後，您可以返回腳本並安全地編輯或跳過該列。 SSM非常適合在進行更改之前進行雙重檢查，尤其是如果您不確定。

避免SQL Server錯誤代碼1060的最佳實踐

此錯誤是標準的，但是一旦您知道如何處理，也很容易避免。這裡有一些技巧可以使您免於將來再次擊中它：

  • 始終在添加之前檢查列是否已經存在
  • IF NOT EXISTS在您的腳本中使用邏輯（在受支持時）
  • 堅持清除，一致的列命名
  • 除非需要
  • 在更改日誌或版本控件中保留架構更改的記錄
  • 在上線之前，請在分期數據庫上測試新腳本
  • 使用諸如SSM之類的工具視覺檢查表列
  • 避免不知道該做什麼的情況下複製的SQL

這些小習慣可以幫助您編寫清潔腳本，並避免出現錯誤1060等問題。

結論

SQL Server錯誤1060看起來可能令人困惑，但這僅意味著您嘗試添加已經存在的列。 SQL只是為了保護您的表結構。

修復程序通常很簡單：檢查您的列列表，調整腳本或添加條件以防止重複。一旦您了解了什麼原因，將來很容易避免。

這種錯誤在SQL工作中是典型的。您練習和測試腳本越多，它就越容易。