Amazon Linux EC2实例无法自动运行Advanced Settings配置的User Data脚本

针对你遇到的Amazon Linux T3.micro实例（基于自定义AMI）User Data脚本不自动执行的问题，以下是具体排查步骤和解决方法：

1. 查看User Data执行日志定位错误 #

Amazon Linux中，cloud-init执行User Data的日志默认存放在/var/log/cloud-init-output.log，直接查看日志能快速定位问题：

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

重点关注以下报错：

• No such file or directory：说明cd DIRECTORY中的目录路径不正确
• command not found：说明npm不在root用户的PATH环境变量中
• 权限相关报错：比如目录或文件无访问权限

2. 替换为绝对路径 #

User Data脚本以root身份执行，默认工作目录是/，因此必须使用绝对路径：

• 将cd DIRECTORY改为cd /绝对路径/到/你的项目目录（比如cd /home/ec2-user/my-node-app）
• 手动SSH登录后执行which npm获取npm的绝对路径，替换脚本中的npm为绝对路径（比如/usr/local/bin/npm run SCRIPT）

3. 添加调试与环境变量配置 #

在脚本开头加入set -x开启调试模式，日志会输出每一步的执行细节，方便排查：

#!/bin/bash
set -x
export PATH=$PATH:/usr/local/bin  # 根据实际npm路径调整
cd /绝对路径/到/你的项目目录
/usr/local/bin/npm run SCRIPT

如果root用户的PATH未包含npm路径，手动添加环境变量能解决找不到命令的问题。

4. 检查cloud-init服务状态 #

确认cloud-init服务正常运行：

systemctl status cloud-init

若服务异常，可尝试重置cloud-init并重新执行：

cloud-init clean && cloud-init init

（注：此操作仅用于调试，新实例优先通过日志排查）

5. 验证自定义AMI的cloud-init配置 #

自定义AMI可能修改了cloud-init的默认配置，检查/etc/cloud/cloud.cfg文件，确保cloud_final_modules中包含scripts-user模块——该模块负责执行User Data脚本。若缺失，需添加后重新生成AMI。

6. 改用systemd管理应用（推荐） #

如果你的Node.js应用需要长期运行，直接通过User Data启动前台进程可能导致进程退出或初始化卡住，建议用systemd管理：

1. 创建systemd服务文件/etc/systemd/system/node-app.service：

[Unit]
Description=Node.js应用服务
After=network.target

[Service]
User=ec2-user  # 建议用普通用户运行，避免root权限风险
WorkingDirectory=/home/ec2-user/my-node-app
ExecStart=/usr/local/bin/npm run SCRIPT
Restart=always  # 进程崩溃时自动重启

[Install]
WantedBy=multi-user.target

2. 在User Data中添加配置命令：

#!/bin/bash
# 重载systemd配置并启动服务
systemctl daemon-reload
systemctl enable node-app.service
systemctl start node-app.service

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