电商项目部署至Render等平台失败求助

核心问题分析 #

本地运行正常但线上部署出现Cannot GET /，主要原因包括：部署平台配置错误、静态文件路径处理不当、环境变量缺失、第三方服务回调URL未更新。

分步解决方案 #

1. 修正托管平台的命令配置 #

• Build命令：你的项目无需构建步骤，直接留空或填写echo "No build required"即可，不要填npm install（平台会自动执行依赖安装）。
• 启动命令：确保平台的启动命令设置为npm run start，这是你的package.json中定义的启动脚本。

2. 修复静态文件路径问题 #

本地相对路径在生产环境可能出现解析错误，改用path模块处理绝对路径：
修改index.js中的相关代码：

const path = require('path'); // 顶部引入path模块

// 替换静态文件服务配置
app.use(express.static(path.join(__dirname, 'frontend')));

// 替换feedback路由中的sendFile
app.get('/feedback', async (req, res) => {
    // ... 原有逻辑保持不变
    res.sendFile(path.join(__dirname, 'frontend', 'index.html'));
});

3. 配置环境变量 #

• 移除代码中硬编码的MercadoPago access_token，将其放入.env文件：

  MERCADOPAGO_ACCESS_TOKEN=TEST-xxxxxx
  

  然后在代码中读取：

  mercadopago.configure({
      access_token: process.env.MERCADOPAGO_ACCESS_TOKEN,
  });
  

• 在托管平台的环境变量设置中，添加所有本地.env中的变量（包括Google Sheets的认证信息）。

4. 更新MercadoPago回调URL #

将代码中硬编码的back_urls替换为平台分配的线上域名：

let preference = {
    items: [],
    back_urls: {
        "success": "https://your-app-domain/feedback",
        "failure": "https://your-app-domain/feedback",
        "pending": "https://your-app-domain/feedback"
    },
    auto_return: "approved",
};

（替换your-app-domain为平台给你的实际域名，比如vionza-ecommerce.onrender.com）

5. 确保Google Sheets权限正常 #

• 确认用于访问Sheets的服务账号邮箱已被添加为Sheets文档的协作者（拥有编辑权限）。
• 确保服务账号的密钥文件已正确配置到环境变量或项目中（避免将密钥文件上传到代码仓库）。

6. 验证部署日志 #

部署失败或出现404时，查看平台提供的日志：

• 检查是否有依赖安装失败的提示
• 确认服务器是否正常启动（日志中是否出现Example app listening on port xxx）
• 排查是否有Google Sheets或MercadoPago的权限/认证错误

额外注意事项 #

• 不要将.env、服务账号密钥等敏感文件提交到代码仓库，用.gitignore排除。
• 生产环境建议使用MercadoPago的正式access_token，而非测试token。

内容的提问来源于stack exchange，提问作者Lucas Yañez Bogni