根本原因是PHP版本低于8.1或缺少ext-grpc/ext-curl扩展，需升级PHP、安装对应扩展，并确认OTLP端点与collector监听地址一致，同时严格管理Span生命周期。
composer require 装不上 open-telemetry/opentelemetry 怎么办
根本原因不是包不存在，而是 PHP 版本或 Composer 配置拦住了。官方 open-telemetry/opentelemetry 包最低要求 PHP 8.1，且依赖 ext-grpc 或 ext-curl（后者仅限部分 exporter）。如果你用的是 PHP 7.4 或 8.0，composer require 会静默失败或报 Your requirements could not be resolved。
- 先运行
php -v确认版本，低于 8.1 就得升级 PHP，别试降级包版本——PHP-SDK 没有向下兼容分支 - 检查扩展：
php -m | grep -E 'grpc|curl'；没grpc的话，OTLPExporterHttp可用，但OTLPExporterGrpc会直接报Class "OpenTelemetry\Contrib\Grpc\Exporter" not found - 如果启用了 Composer 的
minimum-stability为stable（默认），而当前只有dev-main或beta版本，需显式指定：composer require open-telemetry/opentelemetry:dev-main
引入后调用 TracerProvider::getInstance() 报错 Class not found
这不是漏装包，是自动加载没触发或命名空间写错。PHP SDK 不提供全局函数，所有类都严格按 PSR-4 规范组织，且入口类不在顶层命名空间。
- 确保已执行
composer dump-autoload -o，尤其在手动改过composer.json后 -
TracerProvider在OpenTelemetry\SDK\Trace命名空间下，必须use OpenTelemetry\SDK\Trace\TracerProvider;，不能只写use TracerProvider; - 常见手误：
TracerProvider::get_instance()（下划线）——实际是getInstance()（驼峰），PHP 会报Call to undefined method - 若用 Laravel/Symfony，别在配置文件里直接 new 实例；SDK 初始化必须在 request 生命周期早期完成，否则 tracer 可能为 null
链路数据发不到 Jaeger / OTLP 后端，OTLPExporterHttp 一直超时
Exporter 默认走 http://localhost:4318/v1/traces，但这个地址既不等于 Jaeger 的 UI 端口（16686），也不等于其 collector 端口（14250/14268），更不是 Prometheus 的 endpoint。配错就是“没数据”，且无明显报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Jaeger 需额外启动
jaeger-collector并暴露 OTLP HTTP 接口：启动命令加--otlp.http.host-port=:4318 - 用
curl -v http://localhost:4318能返回 404 是正常的（说明服务起来了）；返回 connection refused 才是没跑起来 -
OTLPExporterHttp默认禁用 SSL，如果后端强制 HTTPS，要传['endpoint' => 'https://...']并确保 PHP 支持 TLS 1.2+ - 别忽略环境变量：
OTEL_EXPORTER_OTLP_ENDPOINT会覆盖代码中传的endpoint，调试时先unset OTEL_EXPORTER_OTLP_ENDPOINT
手动创建 Span 没出现在追踪视图里
Span 必须被 Tracer 显式启动、结束，并且所属的 TracerProvider 得提前注册了 Exporter。漏任一环，Span 就进内存然后被 GC 掉，日志里也不会提醒。
立即学习“PHP免费学习笔记（深入）”；
- 必须调用
$span->end()，不能只靠析构函数——PHP 的 GC 不保证及时性，未 end 的 Span 不会被导出 - 确认
TracerProvider::getInstance()返回的对象已调用addSpanProcessor()，例如：new SimpleSpanProcessor(new OTLPExporterHttp()) - Span 名称别用空格或控制字符，Jaeger UI 会过滤掉异常名称；建议用
user.login这种点分格式，别用用户登录 - 如果用 Swoole 或 Hyperf，注意协程上下文：
Span默认绑定到当前协程，跨协程传递需用Context::withValue()+Context::current()，否则子协程里getActiveSpan()是 null
