【亲测免费】 FakeStoreAPI 项目常见问题解决方案

2026-01-29 12:14:56作者：虞亚竹Luna

1. 项目基础介绍和主要编程语言

FakeStoreAPI 是一个免费在线 REST API，提供伪真实电子商务 JSON 数据。它非常适合用于教学目的、示例代码、测试等场景，无需运行任何服务器端代码。该项目的主要编程语言是 Node.js，使用了 Express 框架来构建 API，并使用 MongoDB 作为数据库。

2. 新手在使用这个项目时需要特别注意的3个问题及详细解决步骤

问题1：如何正确安装和运行项目？

解决步骤：

克隆项目： 首先，使用 git clone 命令将项目克隆到本地。
```
git clone https://github.com/keikaavousi/fake-store-api.git
```
安装依赖： 进入项目目录后，使用 npm install 命令安装所有依赖包。
```
cd fake-store-api
npm install
```
配置环境变量： 项目需要一些环境变量来连接数据库。复制 .env.example 文件并重命名为 .env，然后根据需要填写相关配置。
```
cp .env.example .env
```
启动服务器： 使用 npm start 命令启动服务器。
```
npm start
```
访问API： 服务器启动后，可以通过浏览器或 Postman 等工具访问 http://localhost:3000 来测试 API。

问题2：如何处理数据库连接问题？

解决步骤：

检查MongoDB服务： 确保 MongoDB 服务已经在本地或远程服务器上运行。可以使用 mongod 命令启动 MongoDB 服务。
```
mongod
```
检查环境变量： 确保 .env 文件中的 MONGO_URI 配置正确，指向正确的 MongoDB 数据库。
```
MONGO_URI=mongodb://localhost:27017/fake-store
```
检查连接字符串： 如果使用远程数据库，确保连接字符串中包含正确的用户名和密码。
```
MONGO_URI=mongodb://username:password@remote-server:27017/fake-store
```
重启服务器： 修改完配置后，重启服务器以应用更改。
```
npm start
```

问题3：如何处理API请求失败的问题？

解决步骤：

检查API端点： 确保请求的 API 端点正确。例如，获取所有产品的端点是 /products。
```
GET http://localhost:3000/products
```
检查请求方法： 确保使用正确的 HTTP 方法。例如，获取数据使用 GET，创建数据使用 POST。
```
POST http://localhost:3000/products
```

检查请求体： 如果是 POST 或 PUT 请求，确保请求体格式正确，并且使用 JSON.stringify 将数据转换为 JSON 格式。

fetch("http://localhost:3000/products", {
    method: "POST",
    body: JSON.stringify({
        title: "test product",
        price: 13.5,
        description: "lorem ipsum set",
        image: "https://i.pravatar.cc",
        category: "electronic"
    })
})

检查响应状态码： 如果请求失败，检查响应状态码以了解错误原因。常见的错误状态码包括 400（请求错误）、404（未找到）、500（服务器错误）。

fetch("http://localhost:3000/products")
    .then(res => {
        if (!res.ok) {
            throw new Error(`HTTP error! status: ${res.status}`);
        }
        return res.json();
    })
    .then(json => console.log(json))
    .catch(e => console.error(e));