在zabbix平臺上刪除已停用的主機，提示“SQL描述式執行已失敗: "DELETE FROM items WHERE (itemid IN （.....)”，無法刪除，本文為處理情況。
一、問題現象
在zabbix平臺上刪除已停用的主機，提示“SQL描述式執行已失敗: "DELETE FROM items WHERE (itemid IN （.....)”，無法刪除。彈出信息如下：
?彈窗信息為：
SQL描述式執行已失敗: "DELETE FROM items WHERE (itemid IN ('46182','46183','46184','46185','46186','46187','46188','46189','48350','48351','48352','48353','48354','48355','48356','48357','48358','48359','48360','48361','125078','125079','125080'))"
? ? Undefined array key "messages" [zabbix.php:17 → require_once() → ZBase->run() → ZBase->initMessages() in include/classes/core/ZBase.php:530]
foreach() argument must be of type array|object, null given [zabbix.php:17 → require_once() → ZBase->run() → ZBase->initMessages() in include/classes/core/ZBase.php:530]
?二、問題處理
1、嘗試先將主機關聯的模板刪除
嘗試先將主機關聯的模板刪除，保存時出下以下問題彈窗：
?信息內容如下：
? ? pg_query(): Query failed: ERROR: ?update or delete on table "items" violates foreign key constraint "c_functions_1" on table "functions"
DETAIL: ?Key (itemid)=(48351) is still referenced from table "functions". [zabbix.php:17 → require_once() → ZBase->run() → ZBase->processRequest() → CController->run() → CControllerHostUpdate->doAction() → CApiWrapper->__call() → CFrontendApiWrapper->callMethod() → CApiWrapper->callMethod() → CApiWrapper->callClientMethod() → CLocalApiClient->callMethod() → CHost->update() → CHost->updateForce() → CHostGeneral->updateTemplates() → CHostGeneral::unlinkTemplatesObjects() → CDiscoveryRule::clearTemplateObjects() → CDiscoveryRule::deleteForce() → CDiscoveryRule::deleteAffectedItemPrototypes() → CItemPrototype::deleteForce() → CItemPrototype::deleteDiscoveredItems() → CItem::deleteForce() → DB::delete() → DBexecute() → pg_query() in include/db.inc.php:255]
Error in query [DELETE FROM items WHERE (itemid IN ('46182','46183','46184','46185','46186','46187','46188','46189','48350','48351','48352','48353','48354','48355','48356','48357','48358','48359','48360','48361','125078','125079','125080'))] [ERROR: ?update or delete on table "items" violates foreign key constraint "c_functions_1" on table "functions"
DETAIL: ?Key (itemid)=(48351) is still referenced from table "functions".]
可以看到這個錯誤的核心原因是：你要刪除的items表中的記錄（'46182','46183','46184','46185','46186','46187','46188','46189','48350','48351','48352','48353','48354','48355','48356','48357','48358','48359','48360','48361','125078','125079','125080'）被functions表通過外鍵約束c_functions_1引用了。數據庫的外鍵約束會阻止刪除 “被依賴” 的記錄，以保證數據完整性。
三、解決辦法
需要先刪除functions表中引用了相關itemid的依賴記錄，再刪除items表中的目標記錄。具體步驟如下：
1、查看functions表中依賴的記錄
首先登錄 Zabbix 數據庫（PostgreSQL），執行以下 SQL 查詢，找到報錯itemid清單的記錄：
SELECT * FROM functions WHERE itemid in ('46182','46183','46184','46185','46186','46187','46188','46189','48350','48351','48352','48353','48354','48355','48356','48357','48358','48359','48360','48361','125078','125079','125080');
執行后會返回functions表中所有關聯這些itemid的記錄（這些記錄是導致刪除失敗的直接原因）。
2、 刪除functions表中的依賴記錄
根據上一步查詢到的結果，刪除這些依賴記錄
zabbix=# DELETE FROM functions WHERE functionid IN (SELECT functionid FROM functions WHERE itemid in ('46182','46183','46184','46185','46186','46187','46188','46189','48350','48351','48352','48353','48354','48355','48356','48357','48358','48359','48360','48361','125078','125079','125080'));
DELETE 37
zabbix=# ?3、再次刪除主機
從界面再次刪除主機，可以看到主機已正常刪除。
四、注意事項
1、操作前備份
刪除數據庫記錄有風險，建議先備份 Zabbix 數據庫（尤其是items和functions表），避免誤刪數據。
2、理解業務含義
functions表存儲的是 Zabbix 中與監控項相關的 “函數”（如計算方式、觸發器表達式中引用的函數等），刪除這些記錄會影響依賴它們的觸發器、圖形等，需確認這些關聯內容已不再需要。
3、優先通過 Zabbix 界面操作
盡量通過 Zabbix 前端界面（而非直接數據庫操作）刪除監控項，界面會自動處理部分關聯依賴（但復雜場景可能仍需手動處理）。
按以上步驟處理后，即可解決外鍵約束導致的主機刪除失敗問題。
