本文详解 JSON.parse() 在 Node.js 中常见的误用场景，重点纠正赋值运算符误写为等号链导致的语法错误，并提供健壮的 JSON 文件读取与解析实践方案。
本文详解 `json.parse()` 在 node.js 中常见的误用场景，重点纠正赋值运算符误写为等号链导致的语法错误，并提供健壮的 json 文件读取与解析实践方案。
在 Node.js 开发中，使用 JSON.parse() 解析本地 JSON 文件是常见操作，但一个微小的语法失误就可能导致整个应用启动失败。最典型的错误之一，就是将函数调用误写为赋值表达式——例如原代码中的这一行：
const movies = JSON.parse = fs.readFileSync("movies.json", "utf-8"); // ❌ 错误！该语句实际执行了两件非法操作：
- 尝试对只读内置对象 JSON.parse 进行重新赋值（违反 JavaScript 语义）；
- 将 fs.readFileSync() 的返回值（字符串）错误地赋给 JSON.parse，而非传入其作为参数。
✅ 正确写法应为函数调用，即把读取到的字符串作为参数传递给 JSON.parse()：
const movies = JSON.parse(fs.readFileSync("movies.json", "utf-8")); // ✅ 正确不过，仅修正语法仍不足够。生产环境中还需考虑以下关键点：
? 1. 添加异常处理，避免崩溃
JSON.parse() 遇到格式错误的 JSON 会直接抛出 SyntaxError，若未捕获将导致进程退出。建议配合 try...catch 使用：
let movies;
try {
const data = fs.readFileSync("movies.json", "utf-8");
movies = JSON.parse(data);
} catch (err) {
if (err instanceof SyntaxError) {
throw new Error(`Invalid JSON in movies.json: ${err.message}`);
}
throw err;
}? 2. 使用 fs.promises + async/await（推荐现代写法）
为提升可维护性与错误追踪能力，建议采用异步方式并配合 Express 的异步路由处理：
import express from 'express';
import { readFile } from 'fs/promises';
const app = express();
app.get("/api/v1/movies", async (req, res) => {
try {
const data = await readFile("movies.json", "utf-8");
const movies = JSON.parse(data);
res.status(200).json({
status: "success",
data: { movies }
});
} catch (err) {
console.error("Failed to load movies:", err);
res.status(500).json({
status: "error",
message: "Failed to load movie data"
});
}
});
app.listen(3000, "127.0.0.1", () => {
console.log("✅ Server running on http://127.0.0.1:3000");
});⚠️ 注意：原代码中还存在其他问题需一并修正：
- const express = express(); 是重复赋值，应改为 import express from 'express';（ESM）或 const express = require('express');（CommonJS）；
- 路由路径 /api/vi/movies 疑似拼写错误（vi → v1）；
- console.log("Connecting ...") 语义不清，建议明确提示服务已就绪。
✅ 总结：三步确保 JSON 安全解析
- 语法正确：JSON.parse(string) 是调用，不是赋值；
- 容错处理：始终用 try...catch 捕获 SyntaxError 和 I/O 异常；
- 路径与编码校验：确认 movies.json 文件存在、可读，且编码为 UTF-8（无 BOM）。
遵循以上原则，即可彻底规避 JSON.parse 相关的运行时错误，构建更稳定、可调试的 Node.js 服务。
