Railway平台Python脚本Cron定时任务创建失败求助

核心问题 #

你的Railway定时任务失效主要有3个关键原因：

1. Cron表达式格式错误 #

Railway使用标准Unix Cron格式（5个字段：分 时 日 月 周），不支持秒级的6位表达式。你写的*/30 * * * * *是6位（多了秒字段），属于无效配置，Railway无法识别这个定时规则。

2. 脚本执行环境不匹配 #

你用python main.py执行脚本，但项目用Poetry管理依赖，直接调用系统Python可能无法加载项目的依赖环境，导致执行失败或无响应。

3. main.py的逻辑不符合定时任务需求 #

当前main.py是启动FastAPI Web服务的代码，当Cron执行python main.py时，会启动一个持续运行的Web服务进程，而不是执行一次任务就退出。这种情况下，Railway可能会判定任务未正常结束，进而阻止后续定时任务执行。

修复步骤 #

步骤1：修正Cron配置（调整定时规则） #

Railway不支持秒级定时，若要近似实现每30秒执行的效果，可设置Cron任务在每分钟的第0秒和第30秒执行（受限于Railway的分钟级精度，实际是每2分钟执行两次）。修改railway.json的cron字段为标准5位格式：

{
  "$schema": "https://railway.app/railway.schema.json",
  "build": {
    "builder": "NIXPACKS"
  },
  "deploy": {
    "startCommand": "uvicorn main:app --host 0.0.0.0 --port $PORT",
    "restartPolicyType": "ON_FAILURE",
    "restartPolicyMaxRetries": 10
  },
  "cron": [
    {
      "job": "0,30 * * * *",
      "command": "/bin/bash $APP_PATH/cron.sh"
    }
  ]
}

注：若接受每分钟执行一次，可将job字段改为*/1 * * * *。

步骤2：修正Cron脚本的执行命令 #

修改cron.sh，使用Poetry的虚拟环境执行脚本，确保依赖正确加载：

cd /app
poetry run python main.py run_task

步骤3：重构main.py，分离定时任务与Web服务 #

将定时执行的逻辑和Web服务逻辑分离，让脚本可以根据参数判断执行模式：

from fastapi import FastAPI
from pydantic import BaseModel
import datetime
import sys

def run_scheduled_task():
    hora = datetime.datetime.now()
    string_hora = "Executando o script em: " + str(hora)
    print(string_hora)
    # 这里添加你实际要执行的定时任务逻辑

app = FastAPI()

class Msg(BaseModel):
    msg: str

@app.get("/")
async def root():
    hora = datetime.datetime.now()
    string_hora = "Executando o script em: " + str(hora)
    return {"message": f"{string_hora}"}

if __name__ == "__main__":
    if len(sys.argv) > 1 and sys.argv[1] == "run_task":
        run_scheduled_task()
    else:
        import uvicorn
        uvicorn.run(app, host="0.0.0.0", port=int(sys.argv[2]) if len(sys.argv) >2 else 8000)

步骤4：验证定时任务执行日志 #

部署后，在Railway项目控制台进入「Logs」页面，筛选「Cron」类型的日志，查看任务是否正常执行，以及是否有报错信息。

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