Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Vianetsintä tekoälyn avustamana

Oppitunti 9 / 20 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Löydä ja korjaa bugit nopeammin
  2. Vianetsintä virheilmoituksen perusteella
  3. Odottamattoman käyttäytymisen vianetsintä
  4. Tuotantologien analysointi
  5. Vianetsintä jakamalla puoliksi
  6. Tehokkaat vianetsintämallit
  7. Estä tulevat bugit
  8. Keskeiset asiat

Löydä ja korjaa bugit nopeammin

Vianetsintä on edelleen taidelaji: ymmärrä oire, jäljitä se juurisyyhyn ja korjaa se rikkomatta muita toimintoja. Codex auttaa kaikissa kolmessa vaiheessa, mutta epätasaisesti. Ensimmäisessä vaiheessa se ei lisää juuri mitään, sillä sinä havainnoit oireen ja tiedät, miten järjestön pitäisi toimia. Toisessa vaiheessa se loistaa, koska datavirran seuraaminen kymmenen tiedoston läpi on systemaattista lukutyötä – juuri sitä, mitä kone tekee paremmin kuin väsynyt ihminen. Kolmannessa vaiheessa se tarjoaa välittömän varmistuksen testien avulla.

Vianetsintä virheilmoituksen perusteella

Yksinkertaisin tapaus: syötä virheilmoitus sellaisenaan, ilman uudelleenmuotoilua tai tiivistämistä.

"The test src/api/routes/orders.test.ts fails with:
  TypeError: Cannot read properties of undefined 
  (reading 'id')
  at createOrder (src/services/order.service.ts:42)

Find the cause and fix the bug."

Agentti suorittaa sitten kuusi operaatiota ketjussa: se lukee testitiedoston ymmärtääkseen skenaarion, avaa tiedoston order.service.ts rivillä 42, jäljittää datavirran löytääkseen kohdan, jossa undefined otettiin käyttöön, tunnistaa juurisyyt – puuttuva parametri, kirjoitusvirhe tyyppimäärityksessä tai jotain muuta –, ehdottaa ja toteuttaa korjauksen sekä ajaa testin uudelleen varmistaakseen onnistumisen. Kolmas operaatio on se, joka olisi maksanut sinulta kaksikymmentä minuuttia hiljaista lukemista.

Odottamattoman käyttäytymisen vianetsintä

Usein virhettä ei ole lainkaan: ohjelma tekee jotain väärin hiljaa. Nämä ovat kalleimpia bugeja, ja juuri niissä pyyntösi muotoilu on tärkeintä.

"The POST /api/orders route creates the order in the 
database, but the total is always 0. Product prices are 
correct in the products table. Find why the total 
calculation fails."

Tämä ohje toimii, koska se määrittelee laajuuden: mikä toimii, mikä ei, ja yhden hypoteesin, joka on jo suljettu pois, sillä tietokannan hinnat ovat oikein. Codex jäljittää sitten virran HTTP-pyynnöstä lisäykseen, eristää kohdan, jossa laskenta menee pieleen, ja ehdottaa korjausta. Ilman lausetta products-taulusta se todennäköisesti alkaisi tarkistaa juuri sen, mitä olet itse jo tarkistanut.

Tuotantologien analysointi

Voit aloittaa myös tuotantotiedoista liittämällä asiaankuuluvan otteen.

"Here's an excerpt from production logs. The application 
intermittently returns 500 on /api/checkout:

[2026-04-01 14:23:01] ERROR: Connection pool exhausted
[2026-04-01 14:23:01] WARN: Query timeout after 30s
[2026-04-01 14:23:02] ERROR: Transaction rollback

Analyze the checkout route code and identify the connection 
leak."

Codex yhdistää nämä kolme riviä – yhteyspooli tyhjentynyt, kyselyn aikakatkaisu, transaktio peruutettu –, päättelee kyseessä olevan tietokantayhteyden vuodon ja etsii koodista kohdat, joissa yhteys avataan mutta ei suljeta kunnolla. Tämä on tyypillisesti bugi, jota mikään testi ei paljasta, sillä se ilmenee vain kuormituksen alla ja katoaa heti, kun yrität toistaa sitä paikallisesti.

Vianetsintä jakamalla puoliksi

Kun ongelma on hajallaan eikä tarkasti paikannettu, pyydä methodista tutkimusta nopean korjauksen sijaan.

"The TypeScript build fails with 23 type errors since the 
last dependency update. Analyze each error, identify whether 
it's an API change in a dependency, and fix the code to be 
compatible with the new versions."

Tämän muotoilun arvo on siinä, että se pakottaa diagnosoimaan virheen kerrallaan. Ilman ohjetta tunnistaa alkuperä, agentin – kuten päivän päätteeksi väsyneen kehittäjänkin – kiusauksena on lisätä any kunnes kääntäjä vaikenee, mikä muuttaa kaksikymmentäkolme näkyvää virhettä kaksikymmeneksi kolmeksi tulevaksi bugiksi.

Tehokkaat vianetsintämallit

Toimittamasi materiaali ehdollistaa kaiken muun. Jokainen oiretyyppi vaatii mukaan tiettyjä todisteita, ja niiden pois jättäminen on kuin pyytäisi diagnoosia ilman tutkimusta.

OireCodex-ohje
Epäonnistunut testiAnna koko virheilmoitus + testitiedosto
TyyppivirheAnna tsc --noEmit-komennon tuloste
AjoaikavirheAnna pinonjälki (stack trace) + vaiheet virheen toistamiseen
Virheellinen käyttäytyminenKuvaile odotettu vs. havaittu tulos
SuorituskykyongelmaAnna mittarit (vastineaika, hitaat kyselyt)

Estä tulevat bugit

Korjattu bugi on vain puoliksi hoidettu, jos mikään ei estä sen uudelleenilmestymistä muualla. Seuraa siksi korjausta systemaattisesti konsolidointitehtävällä, joka on muotoiltu juuri oppimasi perusteella.

"The bug came from an unchecked null userId. Add type 
guards in all functions in src/services/ that receive a 
userId. Also add a regression test for this case."

Tämä toinen tehtävä yleistää opetuksen tilanteesta, jossa korjaus jäi paikalliseksi: tarkistukset kattavat kaikki palvelut, ja regressiotesti varmistaa, että tämä tietty tapaus pysyy valvonnassa myös projektista poistumisesi jälkeen. Tämä on se liike, joka erottaa tiimin, joka korjaa bugeja, tiimistä, joka pienentää niiden jälkiselvittelyruuhkaa.

Keskeiset asiat

  • Anna Codexille maksimaalinen konteksti: virheilmoitukset, pinonjäljet, logit
  • Codex jäljittää datavirran löytääkseen juurisyyt
  • Se varmistaa korjauksensa ajamalla testit uudelleen automaattisesti
  • Korjauksen jälkeen pyydä suojauksia ja regressiotestejä
  • Mitä tarkempia ohjeesi ovat, sitä nopeampaa vianetsintä on