如何解决Vercel上无数据库PHP应用的404错误？

核心原因 #

Vercel 默认不会自动识别并处理 PHP 文件，即便你重命名了 index.php，如果没有正确配置项目运行环境，Vercel 依然无法解析 PHP 内容，进而触发404错误。另外，未配置数据库可能会引发后续运行时错误，但当前的404问题主要源于PHP解析配置缺失。

具体解决步骤 #

• 添加Vercel配置文件：在项目根目录创建 vercel.json 文件，配置PHP运行规则，示例内容如下：

  {
    "functions": {
      "*.php": {
        "runtime": "@vercel/php@0.7.0"
      }
    },
    "routes": [
      { "src": "/(.*)", "dest": "/$1.php" },
      { "src": "/", "dest": "/index.php" }
    ]
  }
  

  该配置会告知Vercel使用指定版本的PHP运行时处理所有.php文件，并将根路径请求导向index.php。

• 确认项目文件位置：确保index.php处于项目根目录，而非子文件夹中。若文件在子目录，需同步调整vercel.json里的dest路径。

• 查看部署日志排查细节：部署完成后，在Vercel控制台查看部署日志，日志会显示PHP运行时是否加载成功、文件路径是否匹配等具体信息，帮助定位潜在问题。

• 数据库配置提示：当前404问题与数据库无关，但后续项目运行时必然会因缺少数据库配置报错。建议后续在Vercel的环境变量中配置数据库连接信息（如地址、用户名、密码），并确保PHP代码能读取这些变量。

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