创建EC2实例后自动启动Python Web服务器失败排查及方案咨询

可能的错误原因 #

• 前台进程被终止：用户数据脚本默认在前台执行，EC2启动完成后初始化会话结束，前台进程会被直接终止，导致服务停止。
• 环境变量不匹配：手动执行时用的是普通用户环境，而用户数据以root身份运行，可能存在Python路径、依赖包（比如FastAPI）未全局安装的情况，导致root用户无法找到依赖。
• 路径或权限问题：填写的绝对路径可能有误，或者目标Python文件没有被root用户读取/执行的权限。
• 未查看执行日志：没排查脚本执行时的具体报错，无法定位问题。

快速排查步骤 #

1. 查看用户数据执行日志，获取报错信息：

   cat /var/log/cloud-init-output.log
   

   日志里会显示脚本执行的所有输出，包括错误提示（比如找不到文件、Python依赖缺失等）。
2. 验证绝对路径的有效性：

   ls <absolute path of the python file>
   

   确认文件存在，同时检查权限：

   ls -l <absolute path of the python file>
   

   确保root用户有读权限（至少r权限）。
3. 检查root用户的Python环境：

   sudo python3 -c "import fastapi"
   

   如果报错，说明FastAPI只安装在普通用户环境，需要全局安装：

   sudo pip3 install fastapi uvicorn
   

修正用户数据脚本的方法 #

方法1：让进程后台运行并记录日志 #

修改用户数据脚本，用nohup让进程后台执行，同时把输出重定向到日志文件，避免会话结束后进程被终止：

#!/bin/bash
# 确保依赖全局安装（如果需要）
pip3 install fastapi uvicorn
# 后台运行服务，输出日志到指定文件
nohup python3 <absolute path of the python file> > /var/log/fastapi_service.log 2>&1 &

方法2：使用虚拟环境（如果你的服务依赖虚拟环境） #

如果代码依赖虚拟环境，需要在脚本中先激活虚拟环境再启动服务：

#!/bin/bash
# 激活虚拟环境
source /path/to/your/venv/bin/activate
# 后台运行服务并记录日志
nohup python3 <absolute path of the python file> > /var/log/fastapi_service.log 2>&1 &

更可靠的生产级实现方法：Systemd服务 #

用systemd管理服务是更稳定的方案，支持开机自启、进程崩溃自动重启，步骤如下：

1. 在用户数据中写入systemd服务配置并启动服务：

#!/bin/bash
# 安装依赖（如果需要）
pip3 install fastapi uvicorn

# 创建systemd服务文件
cat > /etc/systemd/system/fastapi.service << EOF
[Unit]
Description=FastAPI Web Service
After=network.target

[Service]
User=ec2-user  # 替换为你的普通用户名，比如ec2-user
WorkingDirectory=/path/to/your/app/directory  # 替换为代码所在目录
ExecStart=/usr/bin/python3 /absolute/path/to/your/python/file.py  # 替换为实际路径
Restart=always  # 进程崩溃时自动重启
RestartSec=5  # 重启间隔5秒

[Install]
WantedBy=multi-user.target
EOF

# 重载systemd配置，启用并启动服务
systemctl daemon-reload
systemctl enable fastapi.service
systemctl start fastapi.service

这样配置后，服务会随EC2实例开机自动启动，并且如果服务意外崩溃，systemd会自动重启它，适合生产环境使用。

内容的提问来源于stack exchange，提问作者Ish_codes_magic