本文详解 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 格式非法等异常场景。推荐采用以下健壮写法：
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');
});? 提示：将 API 版本路径 /api/vi/movies（原文拼写错误）修正为 /api/v1/movies，避免因路径 typo 导致 404 掩盖真实问题。
总结：JSON.parse = ... 是典型的“手滑型”致命错误。修复它只需删去多余的 =，但真正专业的做法，是构建带错误捕获、路径安全、格式校验的健壮 JSON 加载流程——这既是调试能力的体现，也是工程化思维的起点。
