JSR项目中目录解析错误的排查与修复

在JSR项目的发布过程中，用户报告了一个"error: Is a directory (os error 21)"的错误。这个错误发生在尝试发布包含复杂目录结构的TypeScript包时，具体表现为Deno发布工具无法正确处理某些目录路径的解析。

问题背景

该错误出现在一个名为@trpc/server的包发布过程中，这个包具有相当复杂的目录结构和导出配置。从jsr.json文件可以看到，该包定义了多个子路径导出，包括各种适配器和核心功能模块。问题特别出现在解析"unstable-core-do-not-import"路径时。

错误分析

核心问题在于路径解析逻辑存在缺陷。当Deno的模块解析器遇到类似"../../unstable-core-do-not-import"这样的相对路径时，它应该尝试解析为两种可能：

1. 作为文件路径："./unstable-core-do-not-import.ts"
2. 作为目录路径："./unstable-core-do-not-import/index.ts"

然而，实际的解析逻辑存在问题：当路径指向一个目录时，解析器错误地直接将目录本身作为解析结果，而不是继续查找目录内的index.ts文件。这导致了"error: Is a directory (os error 21)"的错误，因为系统无法直接将目录作为模块导入。

技术细节

在Node.js和Deno的模块解析规范中，目录导入应该遵循以下规则：

1. 首先检查目录下是否存在package.json文件，并读取其中的main字段
2. 如果没有package.json，则查找index.js或index.ts文件
3. 如果以上都不存在，才应该抛出错误

Deno的原始实现在这一逻辑链上存在缺陷，当遇到目录时没有继续向下查找index文件，而是直接将目录路径作为最终结果传递给了后续处理流程。

解决方案

Deno团队通过PR#22800修复了这一问题。修复的核心内容是完善了模块解析器的行为，确保：

1. 当路径指向目录时，继续查找index.ts文件
2. 只有当目录中不存在可解析的模块文件时，才抛出适当的错误
3. 保持与Node.js模块解析行为的一致性

对开发者的启示

这个案例给模块开发者带来几点重要启示：

1. 复杂的目录结构和子路径导出需要特别注意路径解析的正确性
2. 当使用非标准目录结构(如不使用index.ts而直接使用目录名导入)时，需要确保工具链支持这种用法
3. 发布前的本地测试应该包含各种导入路径的验证

对于使用JSR或Deno发布工具链的开发者，建议：

1. 保持模块结构的清晰和规范
2. 对于特殊路径处理，进行充分的测试
3. 及时更新工具链以获取最新的错误修复

这个问题的解决不仅修复了一个具体的技术问题，也增强了Deno模块系统对复杂项目结构的支持能力，为大型TypeScript项目的模块化管理提供了更好的基础。