FullCalendar 加载大量事件时触发 failure 回调，通常并非因事件数量超限，而是后端 JSON 响应编码异常（如 MySQL 连接未设 UTF-8）导致解析失败；本文详解定位方法与根本性修复方案。
fullcalendar 加载大量事件时触发 `failure` 回调，通常并非因事件数量超限，而是后端 json 响应编码异常（如 mysql 连接未设 utf-8）导致解析失败；本文详解定位方法与根本性修复方案。
在使用 FullCalendar 动态加载事件（尤其是通过 events.url 配置异步获取）时，开发者常误以为“10 条事件正常、100 条失败”是性能或配额问题。实际上，FullCalendar 本身对事件数量无硬性限制，真正瓶颈往往隐藏在数据管道的底层：JSON 响应的字符编码完整性。
从你提供的 events.php 代码可见，关键风险点在于：
- SQL 查询中使用了
strtotime()+$_GET['start']/$_GET['end']，虽经real_escape_string()处理，但未解决连接层编码； -
header('Content-Type: application/json')仅声明响应类型，不保证 MySQL 返回的字符串为合法 UTF-8； - 当事件标题（
title）或描述（description）含中文、德文变音符号（如ü,ö）或特殊符号时，若 MySQL 连接默认使用latin1，json_encode()将输出非法 JSON（如\u0000或乱码字节），前端fetch或 XHR 解析时静默失败，触发 FullCalendar 的failure回调。
✅ 正确修复方式（已在答案中验证）：
在初始化 $mysqli 后立即设置连接字符集为 utf8mb4（推荐）或 utf8：
$mysqli = new mysqli($SETTINGS["hostname"], $SETTINGS["mysql_user"], $SETTINGS["mysql_pass"], $SETTINGS["mysql_database"]);
// ✅ 关键修复：强制连接层使用 UTF-8
$mysqli->set_charset("utf8mb4"); // 更佳选择：支持 emoji 和完整 Unicode
// 或 $mysqli->set_charset("utf8");⚠️ 注意事项：
-
utf8mb4是 MySQL 中真正的 UTF-8 实现（utf8是阉割版，最大仅支持 3 字节字符）； - 数据库表与字段也需确认使用
utf8mb4_unicode_ci等兼容排序规则； -
events.php中json_encode()应增加错误检测，便于调试：
// 替换原 echo json_encode($arr);
$json = json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
if ($json === false) {
http_response_code(500);
error_log('JSON encode error: ' . json_last_error_msg());
die(json_encode(['error' => 'Invalid data encoding']));
}
echo $json;? 排查建议（快速定位根源）：
-
直接访问
events.php?start=2024-01-01&end=2024-12-31，用浏览器或curl查看原始响应，检查是否含乱码或截断； - 在 Chrome DevTools 的 Network → XHR → Response 标签中，确认响应头含
Content-Type: application/json; charset=utf-8； - 使用
console.log(JSON.parse(responseText))手动解析响应，观察是否抛出SyntaxError—— 这是编码问题的明确信号。
总结：FullCalendar 的“事件数量故障”绝大多数源于后端数据流的编码失配。通过显式设置 MySQL 连接字符集、强化 JSON 输出校验，并辅以响应内容直检，即可 99% 规避此类问题。记住——不是日历不够强，而是数据没“说好普通话”。
