部署在Google App Engine的网站PHP联系表单提交时出现404错误

问题分析 #

你的核心问题是表单提交时触发404，但其他功能正常，根源大概率是路径映射不匹配或表单action配置错误，和你回滚PHP版本无关（PHP5.5虽老旧，但GAE仍支持）。

修复步骤 #

1. 恢复正确的app.yaml配置

你最初的app.yaml逻辑是对的，不要只保留PHP handler（会导致静态文件无法访问），恢复完整配置：

runtime: php55
api_version: 1 
threadsafe: true

handlers:
- url: /(.+\.php)$
  script: www/\1

- url: /
  static_files: www/index.html
  upload: www/index.html

- url: /(.*)
  static_files: www/\1
  upload: www/(.*)

这个配置的逻辑是：

• 优先匹配所有.php结尾的URL，映射到www/目录下对应的PHP文件（比如/forms/contact.php对应www/forms/contact.php）
• 根路径/直接返回www/index.html
• 其他请求都映射到www/下的静态文件

2. 检查表单action路径

确保index.html中的表单action是绝对路径，避免相对路径带来的问题：

<form action="/forms/contact.php" method="POST">
  <!-- 表单字段 -->
</form>

如果用相对路径forms/contact.php，当页面URL不是根目录时会出错，绝对路径更可靠。

3. 验证文件路径与依赖引入

• 确认www/forms/contact.php文件确实存在，文件名、文件夹名拼写无错误（比如别写成form/contact.php）
• 检查contact.php中依赖库的引入路径是否正确，要用相对路径：

// 正确：从forms目录向上一级到www，再找assets目录
require '../assets/vendor/php-email-form/php-email-form.php';

不要用绝对路径（比如/www/...），GAE部署后的文件系统路径不是本地的www/结构。

4. 本地测试排查

用GAE本地开发服务器测试：

dev_appserver.py app.yaml

访问http://localhost:8080/forms/contact.php，如果本地也404，说明是文件路径或配置问题；如果本地正常，部署后404，检查部署命令是否上传了所有文件（比如用gcloud app deploy时确保包含www/整个目录）。

额外建议：升级PHP版本 #

PHP5.5已停止维护多年，存在严重安全风险。GAE PHP8.2的前端控制器并不复杂，你可以用一个简单的index.php作为入口：

<?php
$requestPath = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$filePath = __DIR__ . $requestPath;

// 优先处理PHP文件
if (str_ends_with($requestPath, '.php') && file_exists($filePath)) {
    require $filePath;
}
// 处理静态文件
elseif (file_exists($filePath)) {
    $mime = mime_content_type($filePath);
    header("Content-Type: $mime");
    readfile($filePath);
}
// 404处理
else {
    http_response_code(404);
    echo "404 Not Found";
}
?>

对应的app.yaml配置：

runtime: php82
handlers:
- url: /.*
  script: www/index.php

这样所有请求都通过index.php分发，无需复杂的handler规则，还能享受PHP8.2的性能和安全特性。

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