小叨：Node.js 调 AI API 那点儿坑儿

先说一句，咱们玩 AI，别指望一键搞定。

哈哈，hen多小伙伴刚装完 npm 包，立马冲上去写个 await client.chat.completions.create，结果卡死在 Promise 那儿。

说实话，这种情况Zui常见的根源，就是没弄清楚异步到底怎么跑。

别急，我这就给你拆开来聊聊。

坑一：环境变量别写死，别忘了 .env

先把钥匙藏好——.env 文件。

DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
API_BASE_URL=https://api.example.com/v1

注意 KEY 必须大写。这个约定是 dotenv 库的硬性规定。

然后在代码里这么玩：

import dotenv from 'dotenv';
dotenv.config;
const apiKey = process.env.DEEPSEEK_API_KEY;
const baseURL = process.env.API_BASE_URL;

不对不对，应该是把 .env 加进 .gitignore，否则密钥会泄漏到仓库里。

坑二：模块体系选错头疼死

Node Zui早用 CommonJS（require/module.exports)，现在 ES6 模块（import/export)也hen流行。

我这儿给你两段对比：

// CommonJS
const { OpenAI } = require;
module.exports = { client };
// ES6
import { OpenAI } from 'openai';
export const client = new OpenAI;

Ru果文件后缀是 .mjs, 自动走 ES6；要是 .js, kan package.json 里有没有 "type":"module"。

坑三：忘记加 new

这个错误经常被忽视：

const client = OpenAI; // ❌ 报错
// 正确写法
const client = new OpenAI;

# 纠正一下不对不对，上面那句其实根本跑不起来因为 OpenAI 是类，需要实例化才行。

坑四：Promise 没等好就直接打印了

hen多人直接写：

const result = client.chat.completions.create;
console.log;

结果打印出来的是一个 Promise 对象——那叫一个白眼啊！正确姿势是：

const result = await client.chat.completions.create;
console.log;

实战演练：从零到一的完整流程

第一步：初始化项目。

npm init -y
npm i openai dotenv

第二步：建个 .env, 把钥匙塞进去。

第三步：写入口文件，比如 index.mjs****。

import { OpenAI } from 'openai';
import dotenv from 'dotenv';
dotenv.config;
const client = new OpenAI({
    apiKey: process.env.DEEPSEEK_API_KEY,
    baseURL: process.env.API_BASE_URL,
});
const main = async  => {
    console.log;
    try {
        const resp = await client.chat.completions.create({
            model: 'deepseek-chat',
            messages: ,
        });
        console.log;
        console.log;
    } catch  {
        console.error;
    }
};
main;

COPY 完直接跑，你会kan到“你好”。Ru果报错，大概率是密钥或网络问题。

SRE 小技巧：重试 & 超时控制

AIGC 调用一次可Neng要几百毫秒甚至几秒。为了防止卡住进程，Ke以这么包一下：

const fetchWithRetry = async  => {
    for  {
        try {
            return await fn;
        } catch  {
            if  throw err;
            console.warn;
        }
    }
};
...
const resp = await fetchWithRetry => client.chat.completions.create);

# 随手插播——为什么百度不收录？🤔

问： 我写了个技术博客，可是百度搜索根本找不到，是不是我的站点被屏蔽了？

A： 说实话，大多数情况是因为页面缺少关键的 SEO 元素，比如标题标签、meta 描述以及合理的结构化数据。再者，Ru果网站没有备案或 robots.txt 把爬虫拦住也会导致“不收录”。把这些基本要点补齐后再提交 sitemap 给搜索平台，一般就Neng解决啦。你懂的，这事儿跟代码调试差不多——先找根因，再下手修复。

P.S. 常见错误速查表

- API Key 错误 → 检查 .env 是否加载成功；console.log。

- 网络超时 → 加上重试逻辑或使用代理；不要盲目提高 timeout 值，否则浪费资源。

- Token 超限 → 截断历史消息，只保留Zui近几轮；或者使用流式返回降低一次性返回量。

- 环境变量未生效 → 确保在代码Zui顶部调用 .config; 重启 Node 进程。

- 模块冲突 → 切换统一的模块系统，避免混用。

# 小结：避坑秘籍大放送 🎉

先把钥匙藏好，用 .env 防泄漏；再选准模块体系，不然报错像拔草一样多；接着记得实例化类，加 new；Zui后一定要 await 才Neng等到真正的答案。

CACHE 不行，就加重试；Token 爆了就裁剪上下文；SEO 不收录，就补齐 meta 再提交 sitemap。

end note – 老友提醒你：

# 咱就是说这篇文章不是官方文档，只是我在真实项目里踩过的坑儿合集，带点口水味儿，但dou是血泪经验啊！有啥疑问或者想聊聊你自己的奇葩案例，直接甩评论过来吧！哈哈～祝你玩转 Node.js + AI，无痛上线！ 🚀

---