本文深入剖析 Node.js 中 JSON.parse() 的典型误用陷阱，尤其聚焦于将函数调用错误写成赋值语句（如 `JSON.parse = fs.readFileSync(...)`）这一极易被忽视却会导致应用崩溃的语法错误，并系统提供从基础修正、健壮异常处理到现代异步实践（fs.promises + async/await）的完整解决方案，同时指出文件路径、编码、模块导入等配套细节的常见疏漏，助你一次性根除 JSON 解析失败问题，打造高可靠性服务。

本文详解 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"); // ❌ 错误！

该语句实际执行了两件非法操作：

1. 尝试对只读内置对象 JSON.parse 进行重新赋值（违反 JavaScript 语义）；
2. 将 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 安全解析

1. 语法正确：JSON.parse(string) 是调用，不是赋值；
2. 容错处理：始终用 try...catch 捕获 SyntaxError 和 I/O 异常；
3. 路径与编码校验：确认 movies.json 文件存在、可读，且编码为 UTF-8（无 BOM）。

遵循以上原则，即可彻底规避 JSON.parse 相关的运行时错误，构建更稳定、可调试的 Node.js 服务。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。