短链接还原失败主因是Nginx/Apache未将短路径转发至PHP入口，需配置try_files或RewriteRule兜底到index.php；其次base62解码须统一字符表'0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'。
短链接还原时 $_GET 参数被截断或解析失败
常见于 Nginx + PHP-FPM 环境下，短链接形如 /aBc12，但 PHP 无法通过 $_GET['id'] 或 $_SERVER['REQUEST_URI'] 正确拿到原始路径。根本原因是 Web 服务器未将短路径转发给 PHP 入口（如 index.php），导致请求直接 404 或走静态路由逻辑。
解决方式不是改 PHP 解码函数，而是先确保请求能进到你的 PHP 脚本：
- Nginx 配置中需添加
try_files $uri $uri/ /index.php?$query_string;，让所有非文件/目录的请求兜底到index.php - Apache 需启用
mod_rewrite，并在.htaccess中写RewriteRule ^(.+)$ index.php?short=$1 [QSA,L] - PHP 中用
$_SERVER['REQUEST_URI']获取完整路径后，手动提取短码：例如parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)再ltrim($path, '/')
base62_decode() 实现不一致导致还原失败
很多短链系统用 base62 编码 ID（避开 0/O/l/I 等易混淆字符），但各语言、各库的字符表顺序不同。PHP 原生无 base62_decode，若你用第三方函数解码，却和生成端（比如 Python 的 pyshorteners 或 Node.js 的 hashids）用的字符序不一致，必然还原出错。
关键点在于统一字符表 —— 推荐使用标准 base62 字符集：'0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'（小写在前，大写在后）：
立即学习“PHP免费学习笔记（深入）”；
function base62_decode($s) {
$chars = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
$out = 0;
$len = strlen($s);
for ($i = 0; $i < $len; $i++) {
$out = $out * 62 + strpos($chars, $s[$i]);
}
return $out;
}注意：strpos 区分大小写，若传入大写字符而字符表里小写在前，会返回 false → 0，造成错误。务必确认编码端也用同一字符表。
自定义短码（如 /go/wechat）如何与数字 ID 共存
业务常需要支持语义化短码（/go/news）和随机短码（/xYz9）共存。不能只靠长度或正则粗暴分流，否则会误判（比如 /go/123 是语义路径还是数字 ID？）。
建议用「前缀隔离 + 数据库查表」双保险：
- 约定语义短码必须带固定前缀，如
go/、app/、promo/，其余视为随机短码 - 查询时先按完整路径查
short_code字段；没命中，再尝试截掉前缀查alias字段（专存语义名） - 避免在 PHP 中用
switch或大量if映射硬编码，所有映射关系存在数据库，便于运营后台增删
示例 SQL 查询逻辑：
SELECT target_url FROM short_urls WHERE short_code = ? OR (short_code LIKE 'go/%' AND SUBSTRING(short_code, 4) = ?);
重定向跳转时丢失 UTM 或 referrer 参数
用户点击 https://s.example.com/abc?utm_source=weibo，服务端还原后只跳转到 https://target.com/，UTM 全丢了。这不是 PHP 解码问题，而是重定向构造不严谨。
必须显式拼接原始 query string：
- 用
$_SERVER['QUERY_STRING']拿到完整参数串（注意已 URL 解码过） - 还原出目标 URL 后，用
http_build_query()重新编码参数，再拼接 - 避免直接
header('Location: ' . $url . '?' . $_SERVER['QUERY_STRING'])—— 若原始 URL 已含?，会变成双问号
更稳妥做法：
$parsed = parse_url($target_url);
$query = array_merge(
$parsed['query'] ? [] : [],
$_GET
);
$final_url = $parsed['scheme'] . '://' . $parsed['host'] . $parsed['path'];
if (!empty($query)) {
$final_url .= '?' . http_build_query($query);
}
header('Location: ' . $final_url, true, 302);
exit;最易忽略的是：短码还原本身不复杂，但边界场景极多——Nginx 转发规则漏配、base62 字符表错位、语义短码和数字短码冲突、query 参数拼接时未处理空值或重复键。上线前务必用真实 URL（含特殊字符、中文、多重编码）跑一遍端到端链路。
