LND项目中REST端点未找到问题的分析与解决

问题现象

在使用LND(Lightning Network Daemon)的WebSocket接口时，开发者可能会遇到"Not Found"错误。具体表现为当尝试通过Node.js或websocat工具连接/v2/chainnotifier/register/blocks端点时，系统返回HTTP 404错误，提示端点不存在。

问题根源分析

经过技术团队调查，这个问题通常与LND的编译配置有关。虽然LND文档指出自0.15.x版本起所有子系统都会自动编译并激活，但实际上某些REST端点的可用性仍依赖于特定的构建标签(build tags)。

解决方案

要解决这个问题，开发者需要确保在编译LND时包含了所有必要的构建标签。以下是两种推荐的做法：

1. 使用完整构建标签：参考INSTALL.md文档中的说明，明确指定所有需要的构建标签进行编译。例如：

   make build tags="routerrpc signrpc walletrpc chainrpc invoicesrpc"
   

2. 使用release-install命令：这个命令会自动包含所有标准构建标签，是最简单可靠的方法：

   make release-install
   

技术背景

LND采用模块化设计，不同的功能模块可以通过构建标签来控制是否编译。这种设计虽然提高了灵活性，但也可能导致某些功能在特定编译配置下不可用。chainnotifier服务就是一个典型的例子，它依赖于特定的构建标签才能正确暴露REST端点。

验证方法

开发者可以通过以下步骤验证问题是否解决：

1. 使用websocat工具测试连接：

   websocat wss://localhost:8080/v2/chainnotifier/register/blocks?method=POST -H "Grpc-Metadata-Macaroon: ..." --insecure
   

2. 成功连接后，当新区块产生时，应该能看到类似以下的输出：

   {"result":{"hash":"rHFtx3l7d2kR09KTAGFzA7EwgVYcODP5wsJ1hs3KDys=","height":119}}
   

最佳实践建议

1. 在生产环境中，建议始终使用make release-install来确保所有功能都可用
2. 开发环境中如果需要精简功能，务必仔细检查所需功能对应的构建标签
3. 定期查阅LND的更新日志，了解构建配置的变化

通过以上方法，开发者可以确保LND的WebSocket接口正常工作，从而能够实时接收区块链事件通知。