WordPress插件CSV/XLSX上传无通知问题排查求助

• 开启WordPress调试模式与错误日志
  在wp-config.php中添加以下配置：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  

  上传测试后查看wp-content/debug.log，重点排查headers already sent类错误，这类错误直接导致通知无法正常输出。

• 排查隐性输出源

  • 检查所有被引入的文件（包括已注释的菜单类文件），确认文件末尾无多余空格、换行，或意外的echo/print语句；
  • 检查代码中是否使用了PHP短标签<?，部分服务器未开启短标签解析会直接输出标签内容，引发header冲突；
  • 在上传处理函数开头添加输出捕获代码，定位隐性输出内容：

    ob_start();
    // 你的上传处理代码
    $hidden_output = ob_get_clean();
    if (!empty($hidden_output)) {
        error_log('隐性输出内容：' . $hidden_output);
    }
    

• 简化上传逻辑做最小验证
  暂时注释数据解析相关代码，保留最基础的上传验证与通知逻辑，测试是否能正常显示提示：

  function handle_upload() {
      if (isset($_FILES['upload_file'])) {
          add_settings_error('i_upload_notices', 'i_upload_status', '上传测试通知', 'updated');
          settings_errors('i_upload_notices');
          return;
      }
  }
  

  如果此时代通知能正常显示，再逐步恢复原有代码定位问题点。

• 检查浏览器请求响应
  打开浏览器开发者工具（F12），切换到Network面板：

  • 若为AJAX上传，查看请求的HTTP状态码与响应内容，排查是否存在500错误或未捕获的PHP异常；
  • 若为普通表单提交，查看Response标签下的完整输出，确认是否有部分HTML或错误信息打乱页面渲染。

• 排查服务器配置限制

  • 检查php.ini中output_buffering是否开启，设置output_buffering = On可避免少量隐性输出导致的header问题；
  • 核对upload_max_filesize、post_max_size配置，若测试文件超过限制，会导致上传静默失败且无提示。

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