Slim框架jQuery发起GET请求显示(null)未触发路由问题排查

DevOps 小满

2026-8-30

问题根因

你遇到的「服务端日志显示(null) /people、jQuery请求回调不触发」问题和jQuery逻辑无关，核心是两个层面的错误：

PHP内置服务器启动配置错误
PHP内置服务器默认不会自动把请求转发给PHP框架入口文件，当日志里请求方法位置显示(null)时，就代表这个请求没有经过任何PHP脚本执行，是服务器直接返回的静态空响应——你写的Slim/people路由根本没收到请求，自然不会返回预期的JSON数据。而jQuery设置了dataType: "json"时，收到非合法JSON的响应会直接判定请求失败，不会触发你写的成功回调，所以控制台看不到I was here的日志。
代码隐藏逻辑bug
就算路由连通，现有代码也无法正常运行：
- Cypher查询字段别名大小写不匹配：p.firstName AS firstname返回的字段名是小写开头的firstname，前端代码读取的是大写开头的firstName，会拿到undefined
- Neo4j结果处理错误：$result->getResults()返回的是客户端的结果集对象，不是可直接序列化的普通数组，直接json_encode会输出不符合预期的结构
- 接口未返回正确的Content-Type: application/json响应头，部分场景下会导致jQuery解析失败

修复步骤

按顺序操作即可解决问题：

修正PHP内置服务器启动命令
不要直接在项目目录执行裸启动命令，必须指定Slim入口文件作为路由处理脚本。
如果你的项目结构是index.php（Slim入口）在根目录、静态文件在public/目录下，在项目根目录执行以下命令启动服务：
```
php -S localhost:8000 -t public index.php
```
启动后再访问路径，服务端日志就会正常显示GET /people，代表请求已经交给Slim框架处理。

修正/people接口逻辑
替换原有的/people路由代码，修正别名、结果处理、响应头问题：

$app->get('/people', static function (Request $request, Response $response) use ($client) {
    $result = $client->run(<<<'CYPHER'
        MATCH (p:Person)
        RETURN  p.personID AS personID,
                p.firstName AS firstName,
                p.lastName AS lastName,
                p.birthDate AS birthDate,
                p.gender AS gender
        CYPHER);
    
    // 把Neo4j结果集转换为纯数组
    $peopleList = [];
    foreach ($result->getRecords() as $record) {
        $peopleList[] = $record->toArray();
    }

    // 设置JSON响应头，返回数据
    $response = $response->withHeader('Content-Type', 'application/json');
    $response->getBody()->write(json_encode($peopleList, JSON_THROW_ON_ERROR));
    return $response;
});

因为已经把public目录设为静态根目录，原来的/路由可以直接删除，访问根路径时服务器会自动返回public/index.html。

给前端请求增加错误回调
修改前端的AJAX请求逻辑，增加失败回调方便后续排查问题：

$(document).ready(function() {
    console.log("document is ready");
    $.get('/people', function(data) {
        console.log("I was here");
        if(!data) {
            console.log("no data");
            return;
        }
        for(const d of data) {
            console.log(d.firstName);
        }
    }, "json").fail(function(xhr, status, err) {
        console.error("请求失败：", status, err);
        console.log("接口原始返回：", xhr.responseText);
    });
    console.log("passed .get");
});

注意：$(document).ready不要给document加引号，加引号会变成查找名为document的DOM元素，虽然大部分场景不影响，但属于写法错误。

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