Ubuntu 20.04 开机自启动脚本不执行？

Question

在Ubuntu 20.04中，用户常遇到自定义脚本无法开机自动执行的问题。典型表现为：将脚本添加至`/etc/rc.local`或使用systemd服务，但重启后脚本未运行，且无明显错误提示。常见原因包括：`rc-local.service`未启用、脚本权限不足（缺少可执行权限）、脚本路径未使用绝对路径、环境变量缺失，或systemd服务单元文件配置错误（如`ExecStart`指向无效命令）。此外，Ubuntu 20.04默认未启用`rc.local`兼容支持，需手动启用`rc-local.service`并确保脚本以`#!/bin/bash`开头，末尾以`exit 0`结束。排查时应检查`journalctl -u rc-local.service`日志以定位具体失败原因。

Answer 1

一、问题背景与现象描述

在Ubuntu 20.04系统中，许多用户尝试通过传统方式实现开机自启脚本，例如将命令写入/etc/rc.local文件或创建自定义systemd服务单元。然而，尽管配置看似正确，重启后脚本并未执行，且系统未提供明显错误提示。

典型表现为：

• 修改了/etc/rc.local但重启后无效果
• 使用systemctl enable myscript.service启用服务后状态显示active，但实际任务未运行
• journalctl日志中出现权限拒绝、命令未找到或环境变量缺失等隐性错误

二、常见原因深度剖析

该问题的根源并非单一，而是涉及系统初始化机制变迁、权限模型、路径解析和环境隔离等多个层面。以下是按影响层级由浅入深的分析：

层级	原因类别	具体表现
基础层	可执行权限缺失	脚本未设置chmod +x /path/to/script.sh
路径层	相对路径引用	ExecStart=./backup.sh导致找不到文件
服务层	rc-local.service未启用	Ubuntu 20.04默认禁用该兼容服务
环境层	环境变量缺失	脚本依赖$PATH中的命令（如python3）无法识别
配置层	systemd单元配置错误	ExecStart指向不存在的解释器或脚本
架构层	systemd与SysVinit兼容性断裂	rc.local需手动激活支持

三、排查流程与诊断方法

为精准定位问题，建议采用以下结构化排查流程：

# 检查 rc-local.service 是否存在并启用
systemctl status rc-local.service

# 若未启用，则手动启用
sudo systemctl enable rc-local.service

# 查看其运行日志
journalctl -u rc-local.service --since "1 hour ago"
    

若使用自定义systemd服务，检查步骤如下：

1. 确认服务文件位于/etc/systemd/system/myscript.service
2. 确保内容包含正确的[Unit]、[Service]、[Install]段落
3. 重载daemon并启用服务：sudo systemctl daemon-reexec && systemctl enable myscript.service
4. 查看服务详细日志：journalctl -u myscript.service -b

四、解决方案对比与实施策略

根据使用场景选择合适方案。以下是两种主流方式的对比：

# 示例：/etc/systemd/system/myscript.service
[Unit]
Description=My Custom Startup Script
After=network.target

[Service]
Type=oneshot
ExecStart=/bin/bash /opt/scripts/maintenance.sh
RemainAfterExit=yes
StandardOutput=journal
StandardError=journal
Environment=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin

[Install]
WantedBy=multi-user.target
    

而对于rc.local方式，需确保：

• /etc/rc.local文件存在且以#!/bin/bash开头
• 末尾有exit 0
• 文件具备可执行权限：sudo chmod 755 /etc/rc.local
• 对应service已启用：sudo systemctl enable rc-local

五、高级调试技巧与最佳实践

对于复杂脚本，推荐加入日志输出以辅助调试：

#!/bin/bash
{
    echo "$(date): Starting maintenance script..."
    # Your actual commands here
    /usr/bin/python3 /opt/app/clean.py || echo "Python script failed"
    echo "$(date): Script completed."
} >> /var/log/myscript.log 2>&1
    

使用Mermaid绘制自动化启动诊断流程图：

graph TD
    A[系统启动] --> B{rc-local.service 启用?}
    B -- 是 --> C[执行 /etc/rc.local]
    B -- 否 --> D[跳过 rc.local]
    C --> E[脚本是否可执行?]
    E -- 否 --> F[报错: Permission denied]
    E -- 是 --> G[使用绝对路径?]
    G -- 否 --> H[可能找不到命令]
    G -- 是 --> I[环境变量是否完整?]
    I -- 否 --> J[命令执行失败]
    I -- 是 --> K[脚本成功运行]

此外，应避免以下反模式：

• 在rc.local中使用sleep等待服务就绪——应改用After=依赖声明
• 忽略StandardOutput配置导致日志丢失
• 未设置RemainAfterExit=yes导致oneshot服务被误判为失败