WordPress生成带图片vCard及对应QR码遇URL过长问题求助

你遇到的核心问题是Google Chart QR接口本质是GET请求，URL长度上限仅为2048字符，嵌入了base64头像的vCard内容远超过这个限制，直接传递必然报错，以下是三种可直接落地的方案，按优先级排序：

方案1：本地生成QR码（首推，完全规避长度限制） #

直接放弃调用外部Google Chart接口，改用PHP QR Code类库在本地生成二维码，不需要额外服务器权限，兼容Snippets/主题代码注入的使用方式：

• 下载PHP QR Code单文件版本，上传到你的WordPress主题根目录
• 调整现有生成逻辑，直接把完整vCard内容传给QR生成类，最大支持4296字符容量，完全覆盖带base64头像的vCard需求
  示例代码：

// 引入QR类库（路径根据你上传的位置调整）
include_once get_stylesheet_directory() . '/phpqrcode.php';

// 你的原有vCard生成逻辑，得到完整的$vcard_content（包含base64头像）
$post_id = get_the_ID();
$featured_img = get_the_post_thumbnail_url($post_id, [200,200]);
$img_base64 = base64_encode(file_get_contents($featured_img));
// 这里替换为你原来的vCard拼接逻辑
$vcard_content = "BEGIN:VCARD\nVERSION:3.0\nFN:测试联系人\nPHOTO;ENCODING=b;TYPE=JPEG:{$img_base64}\nEND:VCARD";

// 直接输出QR码到浏览器，第四个参数为二维码大小可自行调整
QRcode::png($vcard_content, false, QR_ECLEVEL_L, 4);

方案2：接口中转（兼容外部QR接口调用需求） #

如果必须使用Google Chart或者其他外部QR接口，不要直接传递vCard内容，新增自定义接口动态输出vCard，仅把接口地址传给QR接口：

• 注册自定义Rewrite规则，实现通过yoursite.com/vcard/[文章ID]的链接访问对应文章的vCard
• 生成QR码时仅传递这个短链接，用户扫码后会自动请求接口下载完整vCard
  示例代码：

// 注册自定义vCard访问规则，添加到Snippets即可生效
add_action('init', function() {
    add_rewrite_rule('^vcard/([0-9]+)/?$', 'index.php?vcard_post_id=$matches[1]', 'top');
    add_rewrite_tag('%vcard_post_id%', '([0-9]+)');
    // 首次添加后需要到WP后台-设置-固定链接 点击保存刷新规则
});

add_action('template_redirect', function() {
    $post_id = get_query_var('vcard_post_id');
    if (empty($post_id) || !get_post($post_id)) return;
    // 你的原有vCard生成逻辑
    $featured_img = get_the_post_thumbnail_url($post_id, [200,200]);
    $img_base64 = base64_encode(file_get_contents($featured_img));
    $vcard = "BEGIN:VCARD\nVERSION:3.0\nFN:".get_the_title($post_id)."\nPHOTO;ENCODING=b;TYPE=JPEG:{$img_base64}\nEND:VCARD";
    // 输出vCard文件
    header('Content-Type: text/vcard; charset=utf-8');
    header('Content-Disposition: attachment; filename="'.get_the_title($post_id).'.vcf"');
    echo $vcard;
    exit;
});

生成QR码时仅需传递https://你的域名/vcard/123/（123替换为对应文章ID）即可，URL长度远低于Google Chart的限制。

方案3：压缩vCard体积（仅作为临时优化方案） #

如果不想调整现有架构，可通过压缩内容降低长度：

• 先把特色图裁剪到200*200像素以内，转WebP格式后再编码为base64，相比PNG/JPG可降低30%以上的base64长度
• 移除vCard中非必要字段，仅保留姓名、联系方式等核心内容，进一步压缩整体字符数

内容的提问来源于stack exchange，提问作者Thomas A.