为何渲染EJS视图时仅触发TypeError: Cannot convert undefined or null to object

我用数据库数据渲染EJS视图，核心渲染代码如下：

<div class="bullet-wrapper">
    <ul role="list">
        <% data.features.forEach(element=> { %> <li>
                <%= element %>
            </li>
            <% }) %>
    </ul>
</div>

页面加载时，Express服务器会因TypeError崩溃，但页面本身能正常显示。我用res.send(data)验证过数据能正常返回，用typeof检测数据类型均为object。

/routes.js里通过异步函数处理数据库数据，之前运行正常，今日开发时突然出现问题。我尝试了一个测试视图：

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <title>test-view</title>
    </head>
    <body>
        <h1>test view</h1>
        <div class="test-section">
            <h4>data is...</h4>
            <p>
                <br>
            </p>
        </div>
        <div>
            <ul>
                <% data.features.forEach(function(item){ %>
                    <li>
                        <%= item %>
                    </li>
                    <% }); %>
            </ul>
        </div>
    </body>
</html>

使用该测试视图时服务器并未崩溃。

具体错误及调用栈 #

H:\work\Paragon\paragon\server\routes.js:71
        features = Object.values(camFeatures);
                          ^

TypeError: Cannot convert undefined or null to object
    at Function.values (<anonymous>)
    at H:\work\Paragon\paragon\server\routes.js:71:20
    at processTicksAndRejections (node:internal/process/task_queues:96:5)

涉及代码片段 #

routes.js中处理逻辑：

var features = [];
features = Object.values(camFeatures);

camFeatures的生成代码：

var camFeatures = {};
camFeatures = await getFeatures(req);

getFeatures(req)的逻辑在db.js文件中实现，已参考相关问答调试但未解决，可提供更多代码。

从错误栈可明确定位：问题出在Object.values(camFeatures)——camFeatures的值为undefined或null，导致Object.values无法处理并抛出异常。

排查与修复步骤 #

1. 打印变量确认值：在features = Object.values(camFeatures);前添加console.log('camFeatures:', camFeatures);，查看请求时该变量的实际内容。
2. 检查getFeatures返回逻辑：
   • 确认数据库查询是否存在失败、无匹配数据的情况；
   • 检查getFeatures在异常场景（如连接失败、查询无结果）下是否返回了undefined或null，而非默认空对象。
3. 添加兜底校验：在调用Object.values前先校验camFeatures，避免服务器崩溃：

   var features = [];
   // 基础兜底：仅当camFeatures有效时取值
   features = camFeatures ? Object.values(camFeatures) : [];
   

   或更严谨的类型校验：

   var features = [];
   if (camFeatures && typeof camFeatures === 'object' && camFeatures !== null) {
       features = Object.values(camFeatures);
   }
   

测试视图未崩溃的原因 #

测试视图中若data.features是初始空数组，forEach遍历空数组不会报错；而原视图的崩溃发生在服务器端生成features的阶段，只是之前的请求已返回页面，后续异常才导致服务器崩溃。

内容的提问来源于stack exchange，提问作者Yenmangu