WordPress插件手动可用但Zip包安装失败，提示链接过期

问题场景 #

开发的WordPress插件以JS为主，仅包含少量PHP代码，手动将文件上传至WP插件目录可正常运行，但通过Zip包安装时失败，提示“您访问的链接已过期，请重试”。插件包含符合规范的头部信息、用于返回HTML及注册JS/CSS的代码，还有图片文件与2个JS文件，相关PHP代码如下：

<?php
/**
 * Plugin Name: Plugin name
 * Description: Plugin description
 * Version: 1.0.1
 * Author: Author
 */

function dare2care( $atts, $content, $tag ){

    wp_register_style( 'dare2care', 'https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css' );

    wp_enqueue_style('dare2care');

    wp_enqueue_script('dare2care-quiz', plugins_url( 'dare2care-quiz.js', __FILE__ ), in_footer:true);

    $image_base_url = plugins_url( 'images/', __FILE__ );

 $content = '

    <div id="quiz" class="container">
        ... truncated...
    </div>

';

return $content;

};

add_shortcode('d2c', 'dare2care');

function register_shortcodes(){
    add_shortcode('d2c', 'dare2care');
};

add_action( 'init', 'register_shortcodes');

?>

排查与解决方法 #

1. 检查Zip包结构 #

WordPress要求插件Zip包解压后，根目录直接包含插件的核心文件（如上述主PHP文件）和子文件夹（如images/），不能存在额外的外层文件夹（比如把插件文件夹放在my-plugin-v1.0里再打包）。

• 验证方式：手动解压Zip包，确认根目录下直接可见插件主文件和子目录，没有多余层级。
• 修复：重新打包，确保仅选择插件的核心文件和文件夹进行压缩，不要包含外层包裹目录。

2. 更换压缩工具或调整压缩选项 #

部分第三方压缩工具会添加特殊权限、隐藏文件或使用非常规压缩格式，导致WordPress解压失败。

• 解决：使用系统原生压缩工具（Windows右键「发送到>压缩(zipped)文件夹」、Mac「归档实用工具」）重新打包，避免使用加密、分卷等特殊压缩选项。
• 额外检查：确保所有文件名仅使用英文小写、下划线/短横线，避免空格、中文或特殊字符。

3. 调整服务器内存与超时限制 #

部分低配服务器的PHP内存或执行时间限制较低，解压Zip包时触发超时，表现为“链接过期”的错误提示。

• 临时调整：在wp-config.php文件中添加以下代码，提升内存限制：

  define('WP_MEMORY_LIMIT', '256M');
  define('WP_MAX_MEMORY_LIMIT', '256M');
  

• 若调整后仍无效，需联系主机服务商提升PHP执行时间限制。

4. 清理代码冗余（非安装报错直接原因，但优化后避免后续问题） #

代码中存在重复注册短代码的冗余逻辑：既直接调用add_shortcode('d2c', 'dare2care');，又在register_shortcodes函数中再次注册，建议删除其中一行，避免潜在冲突。

内容的提问来源于stack exchange，提问作者Karina Klinkevičiūtė