VM实例启动脚本未执行求助：Flask应用开机自启失败

常见问题及修复步骤： #

• 绝对路径缺失导致cd失败
  开机启动脚本的默认工作目录不是你手动执行时的用户目录，相对路径的cd命令会直接失败。把脚本里的路径改成绝对路径，比如：

  #!/bin/sh
  cd /home/your_username/documentai_webapp/docai_webapp_instance_gcp
  python3 server.py
  

  替换your_username为VM里的实际用户名。

• sudo多余且引发权限问题
  开机启动脚本通常以root身份执行，不需要加sudo，反而可能因为无交互权限导致执行失败。直接去掉sudo，同时建议使用python3的绝对路径（用which python3查看路径），避免环境变量找不到：

  #!/bin/sh
  cd /home/your_username/documentai_webapp/docai_webapp_instance_gcp
  /usr/bin/python3 server.py
  

• 添加日志排查错误
  给脚本加上日志输出，方便定位问题：

  #!/bin/sh
  # 切换目录失败就退出，避免后续执行出错
  cd /home/your_username/documentai_webapp/docai_webapp_instance_gcp || exit 1
  # 把输出和错误都写入日志文件
  /usr/bin/python3 server.py >> /var/log/flask_startup.log 2>&1
  

  之后可以通过cat /var/log/flask_startup.log查看具体报错信息。

• 改用systemd服务更可靠
  启动脚本的稳定性不如systemd服务，推荐用systemd管理：

  1. 创建服务文件：sudo nano /etc/systemd/system/flask-app.service，写入以下内容：

     [Unit]
     Description=Flask DocumentAI Web App
     After=network.target
     
     [Service]
     User=your_username
     WorkingDirectory=/home/your_username/documentai_webapp/docai_webapp_instance_gcp
     ExecStart=/usr/bin/python3 server.py
     Restart=always
     
     [Install]
     WantedBy=multi-user.target
     

  2. 刷新配置并启用服务：

     sudo systemctl daemon-reload
     sudo systemctl enable flask-app.service
     sudo systemctl start flask-app.service
     

  这样VM开机时会自动启动Flask应用，服务挂了还会自动重启。

• 检查脚本权限与元数据
  确保你的启动脚本有可执行权限：chmod +x your_script.sh；如果是通过GCP元数据设置的启动脚本，检查元数据里的脚本内容是否完整，没有格式错误。

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