[{"data":1,"prerenderedAt":154},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmain\u002Fmicroservices-troubleshooting":3},{"id":4,"title":5,"body":6,"description":141,"extension":142,"group":143,"meta":144,"navigation":145,"order":146,"path":147,"section":148,"seo":149,"source":150,"stem":151,"version":152,"__hash__":153},"docs\u002Fdocs\u002Fmain\u002Fmicroservices-troubleshooting.md","Microservice diagnostics",{"type":7,"value":8,"toc":137},"minimark",[9,133],[10,11,12,25],"table",{},[13,14,15],"thead",{},[16,17,18,22],"tr",{},[19,20,21],"th",{},"Diagnostic",[19,23,24],{},"Action",[26,27,28,37,45,53,61,69,77,85,93,101,109,117,125],"tbody",{},[16,29,30,34],{},[31,32,33],"td",{},"mapping_todo \u002F GONEX_TODO",[31,35,36],{},"Implement the local interface, descriptor-to-domain field\u002Ferror mapping and factory injection. Remove the compile-time marker deliberately.",[16,38,39,42],{},[31,40,41],{},"wiring_missing",[31,43,44],{},"Call NewProviderForModule once from the caller-owned factory. Static analysis is guidance; test the actual mapped RPC. Raw clients use manual bootstrap.",[16,46,47,50],{},[31,48,49],{},"server_tls_missing \u002F client_tls_missing",[31,51,52],{},"Supply TLS material or explicitly select --dev-insecure for loopback development. No production plaintext default is generated.",[16,54,55,58],{},[31,56,57],{},"invalid_server_tls \u002F invalid_client_tls",[31,59,60],{},"Verify certificate, key, CA, server name and expiration. Doctor parses material; a live handshake validates identity\u002Fconnectivity. Credential contents\u002Fraw loader errors are never printed.",[16,62,63,66],{},[31,64,65],{},"security_flags_conflict",[31,67,68],{},"Unset insecure flags when TLS material is configured.",[16,70,71,74],{},[31,72,73],{},"production_plaintext",[31,75,76],{},"Remove development insecurity; GONEX_ENV=production cannot use it through dev.",[16,78,79,82],{},[31,80,81],{},"port_unavailable",[31,83,84],{},"Stop the conflicting process or change the service-scoped address\u002Fcatalog. The runner never kills unrelated processes. Check\u002Fstart bind races remain possible and child failure is reported.",[16,86,87,90],{},[31,88,89],{},"Shared listener address is ambiguous",[31,91,92],{},"Use GONEX_SERVICES_NAME_HTTP_ADDRESS\u002FGRPC_ADDRESS or select one --service.",[16,94,95,98],{},[31,96,97],{},"contracts_stale \u002F contracts_not_generated",[31,99,100],{},"Explicitly run grpc generate or dev --generate. grpc generate --check checks artifact drift without project writes; explicit generation may prepare\u002Fdownload pinned plugins.",[16,102,103,106],{},[31,104,105],{},"go_version \u002F go_missing",[31,107,108],{},"Select Go 1.27.2 or newer on PATH; dev never downloads a toolchain.",[16,110,111,114],{},[31,112,113],{},"Missing module\u002Fchecksum",[31,115,116],{},"Prepare dependencies explicitly. First local use tidies the root CLI module and retains go.work. For isolated service tidy\u002Fbuild, publish\u002Fselect actual contracts and set GOWORK=off. Never disguise an unpublished module with a production replace.",[16,118,119,122],{},[31,120,121],{},"Orders returns 503",[31,123,124],{},"Check Identity target, TLS and readiness. RPC deadlines remain bounded; do not hide mutating failures with automatic retries.",[16,126,127,130],{},[31,128,129],{},"Worker exits immediately",[31,131,132],{},"Any unexpected child exit, including status zero, stops siblings and returns non-zero.",[134,135,136],"p",{},"No dotenv loading, implicit discovery, required database or central runtime is added. Unix uses process groups. Windows uses Job Objects, attempts console break and uses bounded termination if a console signal is unavailable. Forced termination does not guarantee application callbacks finished cleanup.",{"title":138,"searchDepth":139,"depth":139,"links":140},"",2,[],"Resolve local ports, TLS, contract generation, unfinished mapping and supervised process failures.","md","APPLICATION DESIGN",{},true,132,"\u002Fdocs\u002Fmain\u002Fmicroservices-troubleshooting","build",{"title":5,"description":141},"microservices-dx\u002Ftroubleshooting.md","docs\u002Fmain\u002Fmicroservices-troubleshooting","main","O-S7nEP6bqRUHqClwpSAwlmjJZfjVNGHBS_sLeE34Q4",1792521640530]