如何在Node.js版Azure Function中导入本地文件？

先从这几个方向排查：

1. 核对文件结构与导入路径 #

先确认你的项目结构是否合规，比如：

MyFunctionApp/
├── utils/
│   ├── index.js (或者utils.js)
│   └── package.json（用ESM的话需要）
├── MyFunction/
│   ├── index.js
│   └── function.json
└── package.json

如果utils目录下没有index.js，导入时要写全文件名，比如../utils/utils.js——别依赖Node.js自动找索引文件的行为，本地和Azure环境的模块解析逻辑可能有细微差异，偶尔就会触发找不到文件的问题。

2. 模块系统配置要统一 #

你用的是ESM的import语法，必须确保：

• 根目录的package.json里有"type": "module"，整个项目统一用ESM，不能混用require。
• 别在单个Function的目录下单独放package.json，会打乱Azure的模块解析逻辑。

3. 检查部署与缓存问题 #

偶尔报错大概率和部署缓存有关：

• 部署时用func azure functionapp publish <你的应用名> --publish-local-settings强制同步本地所有文件，避免Azure缓存了旧的目录结构。
• 要是用Zip部署，务必确认压缩包包含了utils目录的所有文件，别漏传了。
• 另外检查.funcignore文件，别把utils目录加到忽略列表里，不然部署时不会上传这个目录。

4. 对齐本地与Azure的Node.js版本 #

本地用的Node.js版本如果比Azure上的新，可能会出现模块解析差异：

• 在根目录package.json里加"engines": {"node": ">=18.x"}（改成你本地用的版本），同时去Azure Portal的Function App配置里，把Node.js版本改成对应的版本。

兜底的稳定方案 #

如果以上都试过还是偶尔出问题，可以把utils打包成本地npm包：

1. 进入utils目录，运行npm init，把包名设成@my/utils之类的自定义名称。
2. 根目录的package.json里加依赖："@my/utils": "file:./utils"。
3. 导入时改成import { myUtilsFunc } from '@my/utils'——这种方式模块解析更稳定，不容易出现路径问题。

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