Flutter搜索功能调用PHP API遇FormatException问题排查求助

错误原因分析 #

核心问题是生产服务器返回的响应为空字符串，导致Flutter端jsonDecode无法解析空内容，抛出"Unexpected end of input"异常。仅部分搜索触发问题，说明：

• 特定查询触发了PHP端的执行错误，但PHP未输出任何合法JSON内容（甚至无错误信息），直接终止执行。
• 生产环境与本地环境存在数据、配置差异，导致部分请求处理失败。

具体可能的触发点：

• 生产数据库中特定查询无匹配数据，或数据包含特殊字符，PHP处理时未做容错处理。
• PHP代码缺失错误捕获逻辑，数据库查询、数据处理失败时直接终止，无输出。
• 生产服务器PHP资源限制（超时、内存不足），导致复杂查询进程被强制终止。
• 字符编码不匹配：生产数据库/PHP的字符集与本地不一致，特殊字符处理出错。

生产服务器XAMPP配置检查项 #

1. PHP错误日志与调试设置 #

• 打开php.ini，设置error_reporting = E_ALL、display_errors = On（排查完成后建议关闭），确保PHP错误能被捕获。
• 查看error_log配置的日志文件路径，检查是否有查询相关的执行错误、警告信息。

2. PHP资源限制配置 #

• 检查max_execution_time：默认30秒，若涉及复杂模糊查询（如大表LIKE匹配），可适当调高至60秒。
• 检查memory_limit：确保内存足够处理查询结果，避免因内存不足导致PHP进程崩溃。

3. 数据库连接与字符集配置 #

• 确认PHP连接生产数据库的账号权限充足，能正常执行SELECT等操作。
• 检查数据库字符集是否与本地一致（如UTF-8），避免特殊字符转义、存储时出错。

4. Apache服务器配置 #

• 查看Apache的error.log，排查是否存在请求被拦截、内部服务器错误（5xx）但Flutter端误判为200的情况。
• 确认mod_rewrite等必要模块已开启，避免API路由无法正常访问。

补充PHP代码优化建议 #

• 强制保证输出合法JSON：无论查询是否成功、有无结果，都要输出JSON格式内容，比如无数据时输出echo json_encode([]);，出错时输出echo json_encode(['msg' => '查询失败']);。
• 增加错误捕获逻辑：用try-catch包裹数据库查询与处理代码，捕获异常并输出错误信息，示例：

try {
    // 数据库查询逻辑
    $result = $connectNow->query($sql);
    $data = [];
    while ($row = $result->fetch_assoc()) {
        $data[] = $row;
    }
    echo json_encode($data);
} catch (Exception $e) {
    echo json_encode(['error' => $e->getMessage()]);
}

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