如何修复 Node.js 中的 JSON.parse 语法错误-js教程-PHP中文网

本文详解 Node.js 中因误用赋值操作符导致 JSON.parse 报错的典型问题，指出 JSON.parse = ... 的非法写法，并提供正确解析 JSON 文件的完整示例、健壮性处理方案及调试建议。

本文详解 node.js 中因误用赋值操作符导致 `json.parse` 报错的典型问题，指出 `json.parse = ...` 的非法写法，并提供正确解析 json 文件的完整示例、健壮性处理方案及调试建议。

在 Node.js 开发中，JSON.parse() 是解析 JSON 字符串为 JavaScript 对象的核心方法。但一个常见且极易被忽视的错误，是将函数调用误写为赋值表达式——例如将 JSON.parse(fs.readFileSync(...)) 错写成 JSON.parse = fs.readFileSync(...)。这不仅会导致运行时错误（如 TypeError: JSON.parse is not a function），还会破坏原生 JSON.parse 方法，使后续所有 JSON 解析彻底失效。

以提问中的代码为例：

const movies = JSON.parse = fs.readFileSync("movies.json", "utf-8"); // ❌ 错误！

该语句实际执行了两步：

将 fs.readFileSync(...) 的返回值（字符串）赋给 JSON.parse —— 覆盖了原生 JSON.parse 函数；
再将该字符串同时赋给 movies 变量。

因此，一旦执行此行，JSON.parse 就不再是函数，后续任何调用（包括 Express 内部的 res.json()）都可能崩溃。

✅ 正确写法应为：

const movies = JSON.parse(fs.readFileSync("movies.json", "utf-8")); // ✅ 调用函数，非赋值

但仅修正语法仍不足够。生产环境中，必须考虑文件读取失败、JSON 格式非法等异常场景。推荐采用以下健壮写法：

cn-json-diff

比较两个 JSON 文件并显示差异。支持嵌套结构、数组及值变更。纯 Python 标准库实现，无需 API 密钥。

下载

const fs = require('fs');
const path = require('path');

try {
  const data = fs.readFileSync(path.join(__dirname, 'movies.json'), 'utf-8');
  const movies = JSON.parse(data); // 安全解析
  console.log('✅ JSON loaded successfully:', movies.length, 'movies');
} catch (err) {
  if (err.code === 'ENOENT') {
    console.error('❌ File not found:', err.path);
  } else if (err instanceof SyntaxError) {
    console.error('❌ Invalid JSON syntax at line', err.lineNumber, ':', err.message);
  } else {
    console.error('❌ Unexpected error:', err);
  }
  process.exit(1);
}

? 关键注意事项：

✅ 始终使用 path.join(__dirname, 'xxx.json') 构建路径，避免因工作目录不同导致文件找不到；
✅ 不要在顶层同步读取大文件（影响启动性能），可改用 fs.promises.readFile + await 或启动后缓存；
✅ 开发阶段建议用 jsonc（带注释的 JSON）配合 VS Code 插件校验格式，或使用 npm install -g jsonlint 预检；
❌ 绝对禁止对原生对象（如 JSON, Array, Object）的属性进行赋值覆盖——这是不可逆的全局污染。

最后，结合 Express 的完整修复版路由示例：

const express = require('express');
const fs = require('fs');
const path = require('path');

const app = express();
const MOVIES_PATH = path.join(__dirname, 'movies.json');

// 启动时预加载并验证
let movies = [];
try {
  const rawData = fs.readFileSync(MOVIES_PATH, 'utf-8');
  movies = JSON.parse(rawData);
  if (!Array.isArray(movies)) throw new Error('Expected array of movies');
} catch (err) {
  console.error('[FATAL] Failed to load movies.json:', err.message);
  process.exit(1);
}

app.get('/api/v1/movies', (req, res) => {
  res.status(200).json({
    status: 'success',
    data: { movies }
  });
});

app.listen(3000, '127.0.0.1', () => {
  console.log('✅ Server running on http://127.0.0.1:3000');
});