快捷導(dǎo)航

Linux系統(tǒng)中systemd服務(wù)啟動(dòng)失敗問(wèn)題排查和解決方法(以ad_auth.service為例)

更新時(shí)間：2025年01月12日 14:23:42 作者：碼農(nóng)阿豪@新空間代碼工作室

在 Linux 系統(tǒng)中,systemd 是管理服務(wù)和進(jìn)程的核心工具,然而,在實(shí)際運(yùn)維中,我們經(jīng)常會(huì)遇到服務(wù)啟動(dòng)失敗的情況,本文將以一個(gè)具體的案例——ad_auth.service 啟動(dòng)失敗為例,詳細(xì)介紹如何排查和解決此類問(wèn)題,需要的朋友可以參考下

引言

在 Linux 系統(tǒng)中，systemd 是管理服務(wù)和進(jìn)程的核心工具。然而，在實(shí)際運(yùn)維中，我們經(jīng)常會(huì)遇到服務(wù)啟動(dòng)失敗的情況。本文將以一個(gè)具體的案例——ad_auth.service 啟動(dòng)失敗為例，詳細(xì)介紹如何排查和解決此類問(wèn)題。通過(guò)本文，你將掌握一套完整的排查思路和方法，幫助你快速定位和解決服務(wù)啟動(dòng)失敗的問(wèn)題。

問(wèn)題描述

在運(yùn)維過(guò)程中，我們發(fā)現(xiàn) ad_auth.service 服務(wù)無(wú)法正常啟動(dòng)。通過(guò) systemctl status ad_auth.service 命令查看服務(wù)狀態(tài)，得到以下日志：

● ad_auth.service - ad-auth
   Loaded: loaded (/etc/systemd/system/ad_auth.service; enabled; vendor preset: disabled)
   Active: failed (Result: exit-code) since Fri 2025-01-10 16:18:00 CST; 4s ago
  Process: 143701 ExecStart=/opt/ad_auth/deployer.sh start (code=exited, status=0/SUCCESS)
 Main PID: 143704 (code=exited, status=1/FAILURE)

Jan 10 16:17:55 admin systemd[1]: Starting ad-auth...
Jan 10 16:17:55 admin systemd[1]: Started ad-auth.
Jan 10 16:18:00 admin systemd[1]: ad_auth.service: main process exited, code=exited, status=1/FAILURE
Jan 10 16:18:00 admin systemd[1]: Unit ad_auth.service entered failed state.
Jan 10 16:18:00 admin systemd[1]: ad_auth.service failed.

從日志中可以看到，ad_auth.service 服務(wù)在啟動(dòng)后很快失敗，狀態(tài)碼為 1/FAILURE。接下來(lái)，我們將逐步排查問(wèn)題的根本原因。

排查步驟

1. 查看詳細(xì)日志

systemctl status 提供的日志信息有限，我們需要使用 journalctl 查看更詳細(xì)的日志：

journalctl -u ad_auth.service -b

-u 參數(shù)指定服務(wù)名稱，-b 參數(shù)限制在當(dāng)前啟動(dòng)周期內(nèi)。通過(guò)查看詳細(xì)日志，我們可能會(huì)發(fā)現(xiàn)更具體的錯(cuò)誤信息，例如文件缺失、權(quán)限問(wèn)題、依賴項(xiàng)未啟動(dòng)等。

2. 檢查啟動(dòng)腳本

從日志中可以看到，服務(wù)啟動(dòng)時(shí)執(zhí)行的腳本是 /opt/ad_auth/deployer.sh start。我們需要檢查該腳本的內(nèi)容和運(yùn)行情況。

2.1 檢查腳本權(quán)限

確保腳本具有可執(zhí)行權(quán)限：

chmod +x /opt/ad_auth/deployer.sh

2.2 手動(dòng)運(yùn)行腳本

手動(dòng)運(yùn)行腳本，查看是否有錯(cuò)誤輸出：

/opt/ad_auth/deployer.sh start

如果腳本中有日志輸出，檢查日志文件或標(biāo)準(zhǔn)輸出/錯(cuò)誤輸出。例如：

/opt/ad_auth/deployer.sh start > /tmp/deployer.log 2>&1

然后查看 /tmp/deployer.log 文件，分析錯(cuò)誤信息。

3. 檢查依賴項(xiàng)

服務(wù)可能依賴于其他服務(wù)或資源。如果依賴項(xiàng)未啟動(dòng)或配置錯(cuò)誤，服務(wù)將無(wú)法正常運(yùn)行。

3.1 查看服務(wù)依賴項(xiàng)

使用以下命令查看 ad_auth.service 的依賴項(xiàng)：

systemctl list-dependencies ad_auth.service

確保所有依賴項(xiàng)都已正確啟動(dòng)。

3.2 檢查網(wǎng)絡(luò)和數(shù)據(jù)庫(kù)

如果服務(wù)依賴于網(wǎng)絡(luò)或數(shù)據(jù)庫(kù)，確保網(wǎng)絡(luò)連接正常，數(shù)據(jù)庫(kù)服務(wù)已啟動(dòng)且配置正確。

4. 檢查配置文件

服務(wù)的配置文件可能存在問(wèn)題，導(dǎo)致服務(wù)無(wú)法啟動(dòng)。

4.1 檢查服務(wù)單元文件

查看 /etc/systemd/system/ad_auth.service 文件，確保配置無(wú)誤：

cat /etc/systemd/system/ad_auth.service

重點(diǎn)關(guān)注以下配置項(xiàng)：

ExecStart：?jiǎn)?dòng)命令。
Environment：環(huán)境變量。
WorkingDirectory：工作目錄。

4.2 檢查應(yīng)用配置文件

如果服務(wù)依賴于應(yīng)用配置文件，確保配置文件存在且配置正確。例如，檢查 /opt/ad_auth/config.ini 或類似文件。

5. 檢查資源限制

如果服務(wù)需要大量?jī)?nèi)存、CPU 或其他資源，可能因?yàn)橘Y源不足而失敗。

5.1 檢查系統(tǒng)資源

使用以下命令檢查系統(tǒng)資源使用情況：

free -h  # 查看內(nèi)存使用情況
top      # 查看 CPU 和內(nèi)存使用情況

如果資源不足，嘗試調(diào)整服務(wù)的資源限制。

5.2 調(diào)整資源限制

在 ad_auth.service 文件中添加資源限制配置。例如：

[Service]
MemoryLimit=512M
CPUShares=1024

然后重新加載配置并重啟服務(wù)：

systemctl daemon-reload
systemctl restart ad_auth.service

6. 檢查端口沖突

如果服務(wù)需要綁定某個(gè)端口，確保端口沒有被其他進(jìn)程占用。

6.1 檢查端口占用

使用 netstat 或 ss 檢查端口占用情況：

netstat -tuln | grep <端口號(hào)>
ss -tuln | grep <端口號(hào)>

如果端口被占用，停止占用端口的進(jìn)程或修改服務(wù)配置。

7. 檢查 SELinux 或防火墻

如果啟用了 SELinux 或防火墻，可能會(huì)導(dǎo)致服務(wù)無(wú)法正常運(yùn)行。

7.1 檢查 SELinux 狀態(tài)

使用以下命令查看 SELinux 狀態(tài)：

sestatus

如果 SELinux 是 enforcing 模式，嘗試將其設(shè)置為 permissive 模式以測(cè)試：

setenforce 0

7.2 檢查防火墻規(guī)則

確保服務(wù)所需的端口已開放。例如：

firewall-cmd --list-ports

如果需要開放端口，使用以下命令：

firewall-cmd --add-port=<端口號(hào)>/tcp --permanent
firewall-cmd --reload

8. 調(diào)試服務(wù)

如果以上步驟無(wú)法解決問(wèn)題，可以嘗試在 ad_auth.service 文件中添加調(diào)試選項(xiàng)。

8.1 添加調(diào)試日志

在 [Service] 部分添加以下內(nèi)容：

StandardOutput=journal
StandardError=journal

然后重啟服務(wù)并查看日志：

systemctl daemon-reload
systemctl restart ad_auth.service
journalctl -u ad_auth.service -b

9. 檢查服務(wù)代碼

如果 ad_auth.service 是一個(gè)自定義服務(wù)，檢查其代碼或邏輯是否有問(wèn)題。例如，檢查是否有未捕獲的異常、資源泄漏或其他問(wèn)題。

總結(jié)

通過(guò)以上步驟，我們可以系統(tǒng)地排查 ad_auth.service 啟動(dòng)失敗的問(wèn)題。以下是完整的排查流程：

查看詳細(xì)日志，定位錯(cuò)誤信息。
檢查啟動(dòng)腳本，確保腳本可執(zhí)行且無(wú)錯(cuò)誤。
檢查依賴項(xiàng)，確保所有依賴項(xiàng)已啟動(dòng)。
檢查配置文件，確保配置無(wú)誤。
檢查資源限制，確保系統(tǒng)資源充足。
檢查端口沖突，確保端口未被占用。
檢查 SELinux 或防火墻，確保服務(wù)不受限制。
添加調(diào)試日志，進(jìn)一步分析問(wèn)題。
檢查服務(wù)代碼，修復(fù)邏輯錯(cuò)誤。

通過(guò)這套方法，我們可以快速定位和解決服務(wù)啟動(dòng)失敗的問(wèn)題，確保系統(tǒng)穩(wěn)定運(yùn)行。

以上就是Linux系統(tǒng)中systemd服務(wù)啟動(dòng)失敗問(wèn)題排查和解決方法(以ad_auth.service為例)的詳細(xì)內(nèi)容，更多關(guān)于Linux systemd服務(wù)啟動(dòng)失敗的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: