Railway：让后端进程真正启动并持续接请求

适合什么场景

Flask API
Express API
需要持续运行的 Node / Python 服务
容器化后端
后台任务或 Worker

静态 VitePress 只需要发布文件，Railway 更常用于必须启动进程的后端。

一次后端部署经历什么

取得代码
  ↓
安装依赖
  ↓
可选 Build
  ↓
执行 Start Command
  ↓
应用监听 PORT
  ↓
平台把公网请求转进服务

Build Command 和 Start Command 不要混

Build

准备代码或产物，例如：

npm run build

Start

真正启动后端进程，例如：

npm start
python app.py
gunicorn app:app

Build 成功后进程立刻退出，可能是没有正确 Start Command，而不是构建问题。

PORT 为什么重要

平台通常向应用提供端口变量。后端要监听平台给出的端口，并允许外部连接。

Express 常见：

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

如果只监听自己写死的端口或 localhost，平台健康检查可能连不上。

环境变量怎样配置

Railway 项目变量中添加：

DATABASE_URL
AI_API_KEY
SESSION_SECRET

本地 .env 不应该作为部署办法上传。变量修改后通常需要重新部署或重启服务才能加载。

两种日志分别回答什么

Build / Deploy Logs

依赖安装成功吗
编译成功吗
构建命令正确吗
镜像是否生成

Runtime Logs

服务启动了吗
是否监听正确端口
请求到达后为什么 500
数据库连接是否失败
进程为什么退出

用户点击按钮返回 500，通常先根据时间去 Runtime Logs 找对应请求。

后端上线后的验证顺序

1. Runtime Logs 显示服务正在监听。
2. 打开健康检查地址，例如 /health。
3. Network 请求真实 API。
4. 查看状态码和 Response。
5. 检查数据库写入。
6. 再连接前端正式域名。

健康检查可以简单返回：

{ "status": "ok" }

它证明服务进程能响应，但不代表数据库和所有功能都正常。

常见失败

Build 成功，服务立刻停止

Start Command 错、程序执行完就退出，或启动时缺变量。

Application failed to respond

检查监听端口、绑定地址、进程是否崩溃和健康检查路径。

前端请求 Railway 出现 CORS

后端没有允许正确前端 Origin。不要为了快速修复直接允许所有来源并携带凭证。

数据库连接失败

检查 DATABASE_URL 是否配置到当前服务、数据库网络是否可达、证书和连接限制。

重新部署后数据消失

可能把数据写进服务内存或临时文件系统，而不是持久数据库或 Volume。

官方参考：Railway 官方文档。

Railway Build Logs 显示成功，但公开 API 无法访问。下一步重点看哪里？

答案：看 Runtime Logs、Start Command、PORT 和绑定地址。构建成功只说明代码准备完成，不代表服务进程正在正确监听。