短链接无法打开？PHP服务器配置错误排查与修复方法

短链接打不开？问题很可能不在PHP代码本身，而是Web服务器配置“掉链子”：Apache未启用.htaccess重写、Nginx缺失try_files兜底规则、重写参数丢失（缺QSA标志或漏传code）、跳转目标URL非绝对地址，或HTTPS环境下混用HTTP协议导致浏览器拦截——这些看似细微的配置偏差，才是造成404、空白页、参数为空、跳转失效的真正元凶；动手检查服务器响应头、打印调试日志、验证数据库URL格式、统一协议处理，比盲目修改PHP逻辑更高效、更治本。

短链接跳转 404 或空白页，先查 Apache/Nginx 是否转发了 .htaccess 或重写规则

PHP 短链接服务（如使用 index.php?id=abc 或伪静态 /abc）打不开，大概率不是 PHP 代码问题，而是 Web 服务器根本没把请求交给 PHP 处理。比如访问 /xyz 时，Nginx 直接返回 404，压根没进 index.php。

• Apache 用户检查 .htaccess 是否启用：AllowOverride All 必须在对应 块中配置，否则重写规则不生效
• Nginx 用户确认是否包含 try_files $uri $uri/ /index.php?$query_string;（Laravel 风格）或类似兜底转发逻辑；漏掉这行，/abc 就会 404
• 用 curl -I http://yoursite/abc 看响应头中的 HTTP/1.1 404 还是 302，前者是服务器拦截，后者才可能到 PHP 层

$_GET 拿不到短码？检查 URL 重写后参数是否被丢弃

即使请求进了 index.php，也可能因重写规则写错导致原始短码丢失。典型表现：访问 /abc，但 var_dump($_GET) 输出空数组。

• Apache 的 RewriteRule 要带 [QSA] 标志（Query String Append），否则原有查询参数会被覆盖；伪静态规则如 RewriteRule ^([a-zA-Z0-9]+)$ index.php?code=$1 [L,QSA]
• Nginx 中若用 rewrite ^/([a-zA-Z0-9]+)$ /index.php?code=$1 last;，注意不要漏掉 ?code=$1 —— 写成 /index.php 不带问号参数就全丢了
• 临时加一行 file_put_contents('/tmp/debug.log', print_r($_SERVER, true), FILE_APPEND); 查看 REQUEST_URI 和 QUERY_STRING 实际值，比猜更可靠

短链接跳转后目标 URL 404，确认数据库里存的是完整 URL 还是相对路径

还原短链接本质是查库 + 302 跳转，但常有人把 http:// 漏存或误存为 //example.com、/path 这类非绝对地址，导致跳转出错。

• 执行 SQL 查一条短码记录：

  SELECT code, url FROM short_urls WHERE code = 'abc';

  看 url 字段值是否以 http:// 或 https:// 开头；如果不是，跳转就会变成相对路径（例如当前页是 https://a.com/admin，跳 /login 就变 https://a.com/login）
• PHP 跳转前做基础校验：

  if (!filter_var($target_url, FILTER_VALIDATE_URL)) {
      http_response_code(400);
      exit('Invalid redirect target');
  }

• 插入短链接时用 filter_var($input, FILTER_SANITIZE_URL) 清洗，但注意它不补协议，得自己判断并 prepend

HTTPS 环境下跳转被浏览器拦截？检查 Location 响应头是否混用协议

站点开了 HTTPS，但数据库里存的是 http:// 链接，现代浏览器（尤其 Chrome）会对非安全跳转弹“不安全内容”警告甚至静默拦截，表现为点击后页面卡住或白屏。

• 强制统一跳转协议：在跳转前用 str_replace('http://', 'https://', $url) 粗暴处理（仅限已知全站 HTTPS）
• 更稳妥做法是解析原 URL：

  $parsed = parse_url($url);
  if ($parsed && !empty($parsed['scheme']) && $parsed['scheme'] === 'http') {
      $url = 'https://' . ltrim($url, 'http://');
  }

• 用 curl -v https://yoursite/abc 观察 响应头输出，确认跳转地址协议是否匹配当前页面

到这里，我们也就讲完了《短链接无法打开？PHP服务器配置错误排查与修复方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！